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INPUT /OUT PUT CONTROL TECHNIQUE 
This invention pertains to a new and improved method 
for communicating input/output (I/O) functions between 
one or more central processing modules and one or more 
5 I/O adapter modules in a computer system, through the use 
of multiple levels of a communication structure based on 
shared memory structures in a common pool of main memory 
in the computer system. 

This invention is related to another invention for 
10 an "Arbitration Technique for a Split Transaction Bus in 
a Multiprocessor Computer System," described in United 
States patent application serial number 909,773, and 
filed concurrently herewith, and assigned to the assignee 
hereof. The disclosure of this co-pending application is 
15 incorporated herein by this reference. 

Brief Background of the Invention 
Most modern computer systems, especially 
multiprocessor systems, will run a plurality of user or 
application tasks concurrently. Each of these tasks, and 
20 the operating system itself, generate input/output (I/O) 
requests as the programs run. Usually these I/O requests 
are uncorrelated, which means that the requests have no 
specific relationship to each other between tasks. It is 
of considerable importance to handle the I/O requests 
25 efficiently and effectively so as to not unduly restrict 
the data throughput or processing capabilities of such 
multi-task computer systems. 

In a computer system, there is at least one central 
processor, a main memory, and one or more I/O channels 
30 connected to I/O devices. These elements are connected 
within this processor-memory complex for doing 
input/output data communications. In many prior systems, 
the connection between the processor and the I/O channel 
is a fixed connection. If there is only one processor, 
35 as in a uniprocessor computer system, the fixed connec- 
tions between the I/O devices and the processor do not 
create any restriction, because the single processor 
which controls all of the I/O devices can only proceed 
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with one function at a time. In multiprocessor systems, 
those which involve multiple central processors, the 
fixed connection of each I/O channel to one processor can 
create problems. if the program running on one processor 
needs to access a device on an I/O channel connected to a 
different processor, the communication can occur, but 
only over a circuitous route. Such circuitous routes 
generally create inefficient data transfers and unneces- 
sary data movement within system memory. The 
inefficiencies result primarily from the fixed con- 
nectivity of each I/O channel -_o a specific processor. 

Data communication in a multiprocessor system some- 
times requires the movement of data from one memory loca- 
tion to another memory location as a result of the fixed 
connectivity. It is usually inefficient to move data 
from one memory location to another memory location, 
because such memory movements do not contribute to mean- 
ingful data throughput or data processing efficiency. 
Moving data between a peripheral device and memory in 
either direction is acceptable, but moving data between 
different locations in main memory should generally be 
avoided if possible. 

One common method of handling I/O requests in prior 
art computer systems is to utilize interrupts for 
accomplishing input/output functions. However, the 
nature of most modern processors (including the entire 
current generation of high performance microprocessors) 
is that interrupts are handled only at the expense of 
consuming relatively large amounts of time and processing 
resources. Accordingly, minimizing the occurrence of 
interrupts is quite important. Minimizing the occurrence 
of interrupts is also quite difficult with such prior art 
computer systems. 

In many prior art multi-task multiprocessor systems, 
the I/O drivers tend to be somewhat complex in nature and 
it tends to be difficult to maintain their operating 
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rout'ines. This problem is further compounded .if the I/O 
drivers and the processors to which they are connected in 
a fixed manner utilize specific operating codes applica- 
ble only to particular processor and the particular con- 
5 nected I/O drivers. The lack of commonality in such 
fif arrangements adds to the complexity of the system and 
generally involves inefficiency of data processing and 
data throughput. 

In the past, some computer systems have used I/O 
"10 processors or peripheral processors to essentially 

attempt to partition the I/O control functions between 
the I/O processors and the central processors of the sys- 
tem. Some of these I/O processing systems have worked 
reasonably well, but far more of them have actually 
15 slowed down data throughput and resulted in worse effi- 
ciency due to the added overhead in communicating between 
the central processor and the I/O processor. 

Summary of the Invention 
Generally summarized, the present invention is for a 
20 method of communicating with I/O adapters and the I/O 
devices attached to them by ut i 1 fzTng shared memory 
structures in main memory. Any processor in the computer 
system can communicate with any other processor, I/O 
adapter or I/O device through the shared memory struc- 
*25 tures, because the I/O adapters and the processors of the 
•->'? system are commonly connected by the bus to main memory. 
* The method of the present invention utilizes a 

| multilevel communication structure. The first memory 
\ structure, designated a Mai lbox, is established for hold- 
"*3 0 in 9 data for communicating module information between 
each processor and each I/O adapter. A second memory 
structure is established for holding data for 
communicating I/O device information between processors 
and the I/O devices associated with each I/O adapter. A 
35 third memory structure is established for holding data 
for communicating I/O device operations and for 



WO 88/02149 



PCT/LS87/02394 



transferring data to and from the I/O device utilizing 
predetermined memory locations. A fourth memory struc- 
ture is optionally established for holding data* for 
communicating additional I/O device operations when the 
third memory structure is of insufficient capacity to 
fully specify the I/O device operation. 

There is considerable uniformity in the structure of 
and content of the data placed in each memory structure, 
resulting in the use of only one operating code for all 
10 i/o operations in the system. The arrangement also 

avoids the use of I/O processors, since data within the 
memory structures is capable of being directly inter- 
preted to control state engines or sequencers in each I/O 
adapter by which to perform the I/O data transfers. Once 
the memory structures are established, communication to 
and from the processors occurs directly through the 
structures, thereby avoiding restrictions resulting from 
requirements for communication through all hierarchical 
levels of the communication structure. Problems of fixed 
connectivity and of memory to memory movement are avoided 
by utilizing the shared memory structures and the multi- 
ple levels of the communication structure with pointers 
between them. 

The present invention can be understood more com- 
25 pletely by referring to the accompanying detailed 

description of a presently preferred embodiment of the 
invention, and to the accompanying drawings. The scope 
of the invention itself, however, is defined by the 
appended claims. 
30 Brief Description of the Drawings 

Fig. 1 is a block diagram of a tightly coupled 
multiprocessor computer system illustrating shared struc- 
tures in main memory of the system through which communi- 
cation is achieved between central processor modules and 
35 I/O adapters of the system, in accordance with the I/O 
control technique of the present invention. 
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Fig.. 2 is an illustration of the four levels cf com- 
munication structure of the present invention. Each of 
the blocks illustrated in Fig. 2 represents the control 
structures in the main memory of the computer system 
5 illustrated in Fig. 1, through which communication 
v between the central processing modules and the I/O 

adapter modules, is achieved. 

Fig. 3 is a block diagram similar to Fig. 1 addi- 
tionally illustrating I/O devices attached to I/O adapter 
10 modules and further illustrating Module' Attention, Device 
Attention and interrupt request signals communicated 
between the central processing modules and the I/O 
adapter modules, which form a part of the I/O control 
technique of the present invention. 
15 Fig. 4 is a block diagram similar to Fig. 3 

illustrating the control structures shown in Fig. 2 in 
main memory modules of the computer system, and the com- 
munication path of signals between a central processing 
module and an I/O adapter module to these shared struc- 
20 tures in main memory. 

Fig. 5 is a block diagram illustrating the various 
control structures shown in Fig. 2 in greater detail. 

Figs. 6, 7 and 8 are illustrations of the memory 
layouts of common substructures employed in several of 
25 the control structures illustrated in Fig. 5, specifi- 
V,-/ cally a Command/Status Doubleword, an Extent Descriptor, 

and an Interrupt Descriptor, respectively. 

Figs. 9, 10, 11, 12 and 13 are illustrations of the 
memory layouts of the control structures for the Mailbox, 
•.^•v- 30 Queue Descriptor, I/O Descriptor, Transfer Control List, 
and Exception Status Block, respectively, all of which 
•• are shown in Fig. 5. 

Fig. 14 is a state transition diagram illustrating 
the operation of an exemplary device attached to an I/O 
35 adapter module, in accordance with the present invention. 
Detailed Description 
A tightly coupled multiprocessor computer system, 
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for which the present invention offers substantial advan- 
tages but is not necessarily restricted, is illustrated 
m Fig. 1. The system comprises a plurality of central 
processor modules 20 and a plurality of input/output 
(I/O) adapter modules 22 which are connected by a system 
- I bus 24. The computer system also utilizes a common pool 
•of main memory formed by memory module s 26. Each I/O 
adapter module '22 is connected to one or "mo re I/O 
devices, not specifically shown in Fig. 1. All communi- 
cations between the central processor modules and the I/O 
adapter modules occurs through structures 28 in one or 
more of the main memory modules 26. Each structure 23 is 
one or more addressable memory locations in the main mem- 
ory modules 26. 

Since all of the modules in the system are connected 
to the bus 24, the central processor modules 20 and the 
adapter modules 22 can each access the structures 28 in 
the main memory modules 26. It is therefore apparent 
/that there is no fixed connection between any of the cen- 
tral processors and any particular I/O adapter. Instead, 
any central processor can access any I/O adapter by writ- 
ing to the structures 28 in main memory-, and thereafter 
the I/O adapter can read the structures. Similarly, any 
adapter module 22 can communicate information to any cen- 
tral processor module by writing to the structures 28 and 
the central processor can thereafter read the structures 
28. The communication between the processor modules 20 
and adapter modules 22 thus offers dynamic connectivity, 
thereby avoiding the use of circuitous data routing and 
memory to memory movements. By employing the I/O control 
technique of the present invention for communicating 
between the processor and memory modules, the require- 
ments for special codes, peripheral processors and the 
like are avoided. The common applicability of the 
present I/O control technique to all the modules contrib- 
utes to increasing the data throughput and system 
operating efficiency. 
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Although Fig. I illustrates a multiprocessor com- 
puter system, the present invention is equally applicable 
on uniprocessor systems. Substantial advantages occur, 
however, when the present invention is used in a 
multiprocessor computer system. 

In the preferred embodiment of the present inven- 
tion, all control structures 28 are made up of groups of 
doubleword memor y locations which are aligned on 
doubleword boundaries in the main memory modules 26. A 
doubleword consists of a 32 bit entity made up of two 
adjacent 16 bit words. Each word is two bytes in length. 
In the control structures, the doublewords are aligned 
because their low order bytes are located at memory 
addresses which are zero modulo their size in bytes. 
Aligned words are at even addresses and aligned 
doublewords are at addresses which are integer multiples 
of . four . 

The present invention provides a four level communi- 
cation structure utilizing the control structure s in the 
shared pool of main memory. The four levels of the com- 
munication structure are illustrated in Fig. 2. Each 
level includes at least one control structure. The upper 
level control structure is designated a Mailbox ( MB) 30. 
The Mailbox 30 is used for communication between a pro- 
cessor module and an I/O adapter, or between two proces- 
sor modules, and is for dealing with the processor 
modules 20 and adapter modules 22. Functions accessible 
at this level include initialization, diagnosis and error 
recovery. 

There is one Mailbox for each physical module 20 and 
22 (Fig. 1), Each Mailbox exists at a fixed physical 
location or address in the main memory modules 26 (Fig. 
1) which is uniquely associated with each module. The 
fixed physical address or location may be based on an 
assigned module number or any other means by which the 
unique unambiguous address in main memory can be 
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determined. This unique unambiguous address must be such 
that each module can uniquely determine what that address 
is for every other module and access the Mailbox associ- 
ated with every other module. This address is preferably 
based on the slot number or connector into which the 
module is connected as described in the co-pending appli- 
cation described above. 

In addition to the purpose of sending control func- 
tions that concern the modules of the system, the Mailbox 
also serves as means for initializing the lower levels of 
the four level communication structure. These functions 
concern the module itself, and do not relate to any 
device or communications channel attached to the module. 
There are no commands that are sent through the Mailboxes 
30 to actually cause input/output to occur. 

The second level in the communication structure is 
designated by Queue Descriptor s (QD) 32. Each Queue 
Descriptor 32 is created as a result of a command commu- 
nicated through the Mailbox 30. Queue Descriptors are 
also destroyed as a result of commands communicated ' 
through the Mailbox 30. 

In order to perform input/output functions or any 
other communication associated with I/O device control, a 
Queue Descriptor 32 must be created as a control struc- 
ture in main memory 26 (Fig. 1). Once the Queue 
Descriptor has been created, it is possible to communi- 
cate with the device specified when the Queue Descriptor 
was created. Once all necessary Queue Descriptors have 
been created there is little further need for the Mailbox 
and all commurrications other than for catastrophic error 
recovery can directly occur through the Queue Descriptor 
or its subsidiary control structures. 

More than one Queue Descriptor 32 can be created for 
use by a single I/O adapter module by a sequence of 
commands at the Mailbox 30. Most I/O adapters are capa- 
ble of. supporting multiple Queue Descriptors 
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concurrentiy. There is one Queue Descriptor for each 
device attached to the adapter. la this context a 
"Device" refers to an entity supported by the I/O adapter 
in a manner capable of performing I/O operations indepen- 

5 dently from and concurrently with other such entities. 

In the case of single device controllers which are capa- 
ble' multiple concurrent operations (for example, the 
transmitter and receiver portions of a full duplex 
network interface), more than one Queue Descriptor Device 

10 may be associated with a single physical device. How- 
ever, in the case of multiple devices interfaced via a 
device controller not capable of overlapped operations 
(for example, a tape controller which can attach up to 
four tape drives but only transfer to one at a time), a 

15 single Queue Descriptor Device may be associated with 
more than one physical apparatus. 

The functional purpose of each Queue Descriptor 32 
is to hold control information needed by the processors 
and the I/O adapters to maintain a queue of I/O 

20 Descriptors (IOD) 34 for a given Device attached to the 
adapter . 

The actual input/output communication is 
accomplished by interpreting I/O Descriptors (IOD) 34, 
which are utilized at the third level of the communica- 

25 tion structure. Each I/O Descriptor contains the basic 
control information for a single I/O operation by a 
single Device. Each of the I/O Descriptors for a Device 
are linked together in the order of operations to be per- 
formed to establish the Device queue for the Device. The 
"*3 0 Device queue of linked I/O Descriptors allows the I/O 
adapter to proceed to the next command in an I/O 
Descriptor upon the completion of the previous command 
without requiring the intervention of a processor, in an 
operation known as command chaining. This is of consid- 

35 erable advantage in the present invention because it 
reduces or eliminates the necessity of extensive 
interrupts to the processors. 
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In the case of simple I/O Devices, it is generally 
possible to fully specify the I/O operation in the I/O 
Descriptor 34. However, in the case of more complex I/O 
Devices, there is a need for more device specific control 
information. m order to make all of the I/O Descriptors 
34 uniform in content, the extended control information 
for an I/O Device is not included within the I/O 
Descriptor. Instead, an ancillary control structure des- 
ignated as a Device Control Block { DCB ) 36 is created. 

The contents of the Device Control Block 36 are 
arbitrary, and depend on the specific type of I/O Device 
connected to the adapter. The Device Control Block 36 is 
simply a flexible means of allocating memory to hold the 
Device specific commands necessary for accomplishing a 
single I/O operation for a particular I/O Device. The 
Device Control Block 36 occupies the fourth level of the 
communication structure. 

A Transfer Control List (TCL) 38 can also be used in 
conjunction with each I/O Descriptor 34, at the fourth 
level of the communication structure. The Transfer Con- 
trol List is a list of one or more buffer descriptors 
which allow one or more separate, non-contiguous areas of 
memory to be logically associated with a single I/O 
operation. This allows transfers to and from data 
buffers to occur wherever it is most advantageous for the 
data buffers to exist in memory, rather than having to 
move data to pre-allocated or fixed buffers in order to 
accomplish I/O transfers. What is often called a scatter 
or gather capability is obtained. For an output 
operation the_data can be gathered from the separate 
areas of memory, and for an input operation the data can 
be scattered to these separate areas of memory. This 
scattering or gathering capability has.the advantage that 
the information is recorded in buffers where the higher 
level operating software of the system wants the data 
located without involving an unnecessary memory to memory 
movement of that information. 
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An Exception Status 31ock (ES3) 40 is illustrated in 
Fig. 2, although the Exception Status Block is not a dis- 
tinct level within the communication structure. The 
Exception Status Block 40 is logically a part of the 

5 Queue Descriptor 32. The Exception Status Block 40 is 

not physically a part of the Queue Descriptor because it 
is desirable to keep the Queue Descriptor to a fixed 
size. The Exception Status Block 40 is sometimes not 
needed at all, and when it is N needed it is variable in 

10 size. Accordingly, the Exception Status Block 40 is made 

• i separate from Queue Descriptor 32. The Exception Status 
Block 40 is linked to the Queue Descriptor by a pointer. 

The function of the Exception Status Block 40 is to 
provide memory space for storing information concerning 

15 the status of exception conditions which may have 

occurred while performing Device level commands. One 
Exception Status Block is associated with eac.i Queue 
Descriptor 32. While the exceptions reported upon actu- 
ally occur due to processing of I/O Descriptors, alloca- 

20 tion of an Exception Status Block for every I/O 

Descriptor 34 could waste a considerable amount of mem- 
ory, because exceptions in processing I/O functions are 
infrequent. Instead, the use of the single Exception 
Status Block 40 for each Device allows it to be shared 
among a.1-1 of the I/O Descriptors 34 associated with a 
Queue Descriptor 32. In actuality, the function of the 

:. :/ ^ Exception Status Block 40 is down at the fourth level of 
the communication structure, as illustrated in Fig. 2, 
since it records exception conditions relating to the I/O 

^30 Device operations. 

As long as I/O operations complete successfully 
without exceptions, the processing of I/O Descriptors 
will continue sequentially down the Device queue from I/O 
Descriptor to I/O Descriptor. If an exception occurs, 

35 the information explaining what went wrong and when dur- 
ing the operation the problem occurred is placed in the 
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Exception Status 3ioc:< 40, and processing stops until the 
exception is handled by softvare on a central processor. 
When an exception occurs device operations for" chat 
device cannot safely continue and something is indicated 
5 as wrong. Once the exception condition has been cor- 
rected, there is no longer any reason to keep the excep- 
tion information stored in memory, allowing the same 
Exception Status Block 40 to be re-used when processing 
of the Device queue is resumed. 
10 r ' In order to utilize the communication structures 

. illustrated in Fig. 2, and specifically the Mailbox 30, a 
• means or signal of i nstructing a module zo inspect its' 
Mailbox i l_51^j-, red - T.his""instruction to a module to 
inspect its Mailbox is achieved by a logical operation 
15 known as a Module Attention. As is shown in Fig. 3, a 
Module Attention signal is illustrated as originating 
from a central processing module 20a, being communicated 
over the system bus 24 to an I/O adapter 22b. The I/O 
adapter module 22b receives the Module Attention at a 
high priority or non-maskable interrupt. The Module 
Attention causes the I/O adapter 22b to inspect the con- 
tents of its Mailbox by reading the information contained 
in the Mailbox. Such a reading operation is illustrated 
in Fig. 4 wherein the I/O adapter module 22b is receiving 
information from the Mailbox over the system bus 24. The 
information received from the Mailbox instructs the I/O 
adapter 22b to perform certain functions. 

In the previously mentioned application filed con- 
currently herewith, there is described a control space 
transfer operation over the bus. A series of control 
space addresses are allocated for Module Attention func- 
tions in the present invention. m the case of the ore- 
viously mentioned application, the Module Attention has 
been implemented as control transfers conducted over the 
parallel bus of the computer system. The Module Atten- 
tions can also be conducted between modules by serial 
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signal transfers over a bit serial, i.e. a one bit vide 
serial communication link. Any means of sending a signal 
which the module interprets as a Module Attention, which 
causes it to inspect its Mailbox, is sufficient for the 
5 purposes described. The Module Attention signals must be 
uniform and the means for sending them applicable to all 
j_ modules of the system. 

Various Devices 42a, 42b, 42c, 44a, 44b, 44c, 46a 
and 46b are shown connected to the I/O adapter modules 
10 22a, 22b and 22c shown in Figs. 3 and 4. Shown in Figs. 
3 and 4, each Device is connected to each I/O adapter by 
a common I/O channel; however it is also possible for a 
single I/O adapter to connect to multiple, I/O channels in 
support of a plurality of devices. 
15 In order to start the I/O adapter to perform an I/O 

function, a Device Attention command is communicated 
between modules. The Device Attention is directed to one 
of the devices attached to each I/O adapter, as is shown 
in Fig. 3. The Device Attention shown in Fig. 3 is com- 
20 municated between the central processing module 20c and 
the I/O adapter module 22a. The I/O adapter module 22a 
includes circuit elements which recognize the Device 
Attention signal and begin processing the Device queue 
... for a particular identified Device attached to the module 
25 22a. As shown in Fig. 3, device 42b is the target of the 
I/O operations performed as a result of the communication 
of the Device Attention from the processor 20c to the I/O 
adapter 22a. 

The Device Attention signal instructs the I/O 
30 adapter module to inspect the Queue Descriptor for the 
designated Device, and to execute any command which it 
finds in the Device queue supported by the Queue 
Descriptor. Fig. 4 illustrates the effect of the Device 
Attention signal (Fig. 3), in that I/O adapter module 22a 
35 is reading commands for Device 42b from an associated 
Queue Descriptor 34. After the Mailbox command has 
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created Queue Descriptors for each device attached to 
eacn I/O adapter r.cduie, communication between the cen- 
tral processors ar.d the I/O devices occurs directly with 
the Queue Descriptors and not through the Mailbox. The 
commands in the Queue Descriptor which are most usually 
executed upon the receipt of a Device Attention are those 
to initialize the queue, i.e. set the current pointer 
back to equal the head pointer and start at the 
beginning; halt Device queue processing; or continue pro- 
cessing the queue which is to resume queue processing, 
all of which are described in greater detail below. 

Again, as has been described in the co-oending 
application Device Attentions can be communicated through 
control space transfers on the system bus 24. Any means 
15 that allows for an unambiguous communication of a signal 
between any module and any other module would also be 
usable for communicating a Device Attention, provided 
that such a signal also discriminates between the various 
devices attached to an I/O module. 

Each of the control structures which are used in the 
I/O control technique of the present invention are shown 
in greater detail in Fig. 5. All of the control struc- 
tures shown in Fig. 5 are made up of doublewords located 
in aligned doubleword memory locations or boundaries in 
25 the pool of main memory. The number of doublewords in 
each control structure and their field layout and the 
pointer linkages between them are more completely dis- 
cussed below in conjunction with Figs. 6 through 13. 

To achieve simplicity of interpretation and consis- 
tency among the various control structures illustrated in 
Fig. 5, many common substructures are included within 
each of these control structures. The common control 
substructures include a Command/Status Doubleword (CSD) 
and Extent Descriptor (EXTD), and an Interrupt Descriptor 
( INTD ) , shown respectively in Figs.. 6, 7 and 8. 

The Command/Status Doubleword is the fundamental 
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means for processors to send commands to and receive 
status from I/O adapters and devices. The Command/Status 
Doubievord also provides for indicator based synchroniza- 
tion between each processor and the I/O adapters. A 

5 Command/Status Doubleword appears as the first doubievord 
in each Mailbox 30, Queue Descriptor 32, and I/O 
Descriptor 34 as shown in Fig. 5. 

As is shown in Fig. 6 P the Command/Status Doubievord 
50 is a 32 bit entity that is divided into two 16 bit 

■10 words. The high order word, bits 16 to 31, contains 
status information, both basic and extended. The low 
order word, bits 0. to 15, includes command information. 
The low order word is used to communicate information 
from the sender to the recipient through this control 

15 structure. The status word is used to communicate infor- 
mation from the recipient back to the sender. The sender 
module pre- i n i t i al i zes the command word to contain the 
command and command modifier appropriate for what the 
sender module wants accomplished, and initializes the 

20 status word to being essentially null. Subsequently, the 
recipient of this Command/Status Doubleword 50 interprets 
the command information, and then will thereafter inter- 
pret the remaining information in the Mailbox, Queue 
Descriptor, or I/O Descriptor in the context of this 
V2 5 command information. The recipient thereafter performs 
„; the command and reports the successful completion of the 

- command or an error condition upon attempting to execute 
that command. This reporting on the status of the 
command is wruten into the higher order word of the 

=3q Command/Status Doubleword. 

The basic command byte, bits 0 to 7, specifies the 
fundamental operation to be performed by the recipient of 
a Command/Status Doubleword. All other fields in the 
control structure remain either operands for use in per- 

35 forming this command or space to return status concerning 
the command. Unique command codes are assigned for 
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Mailboxes, for Queue Descriptors., and for I/O 
Descriptors, so as to be distinguishable from one 
another. This simplifies command decoding and allcvs 
simple checking for errors related to attempting to exe- 
L cute a command at the wrong level of control structure. 

The command modifier byte, bits 8 to 15, contains 
indicators of modalities pertaining to an adapter's pro- 
cessing of the command indicated in the basic command 
byte. Bit 15 is used in the Command/Status Doublewords 
of Queue Descriptors and I/O Descriptors to contain a 
flag to indicate that the IOD pointer in the doubleword 
immediately following this Command/Status Doubleword 
contains a valid address. This indication is necessary 
to allow 16 bit processors to be used with the present 
invention, since such 16 bit processors are not capable 
of updating doubleword address values in a single bus 
cycle. It is therefore necessary to have this means to 
mark this pointer invalid to prevent the possibility of 
an I/O adapter attempting to use an address pointer with 
only one of its two words valid. When polling an idle 
queue, the bit-15 of this Command/Status Doubleword is 
actually being tested by the I/O adapter. The usage of 
bits 14 to 8 of the command modifier byte is specific to 
particular control structures. 

The extended status byte, bits 16 to 23, is avail- 
able for adapter-specific or device-specific status 
reporting in cases where status information will not fit 
within the basic status byte, bits 24 to 31. The basic 
status byte is the primary means of communicating a com- 
pletion status^of the command specified by this 
Command/Status Doubleword. 

The basic status byte also serves as an interlock to 
restrict access by any processor to the control structure 
containing this Command/Status Doubleword while the con- 
trol structure is awaiting processing by the I/O adapter 
and while the adapter is performing the operation. An 
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interlock provides mutual exclusion locking of a control 
structure. I nterlo cks exclude access by a requestor 
(usually a processor) while a control structure is in use 
by a server (usually an adapter). Bits 31 and 30 serve 
5 as control structure status flags, and these bits are the 
5? general status bits relating to execution of the command 

specified in the basic command byte. 3it 31 also serves 
as the structure interlock. Bit 29 is set to "1", in I/O 
Descriptors, at the end of the operation specified by the 
v-10 basic command status byte if the device function in the 
^ adapter processing this I/O Descriptor requested an 

interrupt as a result of attempting to execute, 
executing, or completing the processing of this command. 
The state of bit 29 is not changed by the adapter other 
15 than when reporting status at the end of an operation. 
Bit 28 is a general purpose status bit for use in a 
structure dependent manner. Bits 27 through 24 contain 
the completion status for the command specified in the 
basic command byte. Completion code assignments are con- 
20 trol structure specific. 

The interlocking function performed by bits 30 and 
31 in the basic status byte is significant in the present 
invention. In multiprocessor computer systems where any 
one of the processors or other modules may seek access to 
'??25 a given memory location or control structure simultane- 
-■'v' ously, it is necessary to have a means by which to pro- 
Si* tect "the critical memory segment so that it may be acted 
on by only one module at a time and until the particular 
transaction is completed. Such an arrangement is known 
:*30 as an interlock, a spinlock, a hardlock or the like. The 

normal manner of implementing an interlock requires an 
5V operation referred to as a test and set. However, as a 

result of the present invention and the use in particular 
of the control structure status flags in bits 30 and 31 
35 of the Command/Status Doubleword, it is possible for the 
present invention to operate successfully in a 
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multiprocessor environment vith true simultaneity without 
requiring the use of test and sets by I/O adapter 
modules . 

The two status flags at bits 30 and 31 of the 
5 Command/Status Doublevord indicate that the processors 

should neither modify the control information nor act on 
the status information in the particular control struc- 
ture while that structure is awaiting processing by an 
I/O adapter or while the I/O adapter is performing the 
10 operation specified in the control structure. 

To provide an indication of when such conflicting 
access may occur, and to prohibit it, the control struc- 
ture status flags at bits 30 and 31 serve as an 
interlock . 

15 The two status flags at bits 30 and 31 can designate 

any one of four states or status codes. A first "avail- 
able" state indicates that there is no active command 
information in the control structure and that any status 
information which may have been present has already been 

20 interpreted by a processor. Control structure contents 
may not be interpreted by adapters while "available" 
status is indicated. 

The two status flags in bits 30 and 31 can also 
indicate "pending". a pending state indicates that a 

25 processor has placed command information into this con- 
trol structure and the control structure is currently 
awaiting processing by an adapter. Control structure 
contents may be neither interpreted nor modified by pro- 
cessors while pending status is indicated. One exception 

30 to this is that, link pointers indicated to be invalid (by 
bit 15 of the command modifier) may be updated to become 
valid and then be marked valid by processors at any time. 
A control structure must be in a pending state when an 
I/O adapter begins to process its contents or the adapter 

35 will generate an error condition and halt its processing. 

Another state indicated by the two status flags of 
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bits 30 and 31 is "busy". A busy state indicates that 
this control structure is being processed by an I/O 
adapter. Control structure contents may not be inter- 
preted nor modified by processors while a busy status is 

5 indicated, other than the update of linkage information 
( noted at bi t 15 ) . 

A "done" status can also be indicated by the two 
status flags at bits 30 and 31. A done status indicates 
that processing of the command specified by this control 

10 structure has been completed by the adapter and that the 
completion status has been returned. Control structure 
contents may' not be interpreted by adapters while done 
status is indicated. 

Examples of codes for the status flags are "00" for 

15 "available", "10" for "pending", "11" for "busy" and "01" 
for "done". Using this set of code values, whenever bit 
31 of the Command/Status Doubleword is set to a "1" other 
status information in the control structure containing 
the Command/Status Doubleword is not guaranteed to be 

20 valid and must not be interpreted by processors. In 

effect, when bit 31 is set to a "1" the control structure 
is "owned" by the I/O adapter, and when bit 31 is set to 
"0" the control structure is "owned" by the central pro- 
cessors. Adapters set the basic status byte to indicate 
• >2 C 5 a busy -status before they read the Command/Status 

Doubleword to obtain the command information. Because 
processors are not permitted to modify control structures 
marked "pending" it is not necessary for the I/O adapter 
to use a test and set transaction to mark the control 

30 structure busy. 

The use of the available status code is at the 
option of system software. Adapters begin processing 
control structures when directed to do so, either by 
attention conditions or command chaining. The adapters 

35 require that the initial control structure be "pending" 
and unconditionally set the status to "busy" and 
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subsequently to "done". The ability to distinguish 
available and done status may be useful to system 
software in generating and managing control structures, 
especially in a multiprocessor environment. If the sys- 
tem software elects not to use the "available" status, 
this software must still keep track of which control 
structures marked "done" are awaiting interpretation by 
I/O driver software and which control structures marked 
"done" are available for re-use. I/O adapters never set 
control structure status to "available". 

Since the operations to switch the state of the 
Command/Status Doubleword can be done with normal write 
operations by either the processors or the I/O adapters, 
there is no need for performing any test and sets in the 
computer system to achieve interlocking between proces- 
sors and I/O adapters. The performance of test and sets 
can be very consumptive of time and the throughput of the 
system is improved by utilizing the normal write function 
to indicate the status in the command status doubleword 
as described above. 

An Extent Descriptor ( EXTD ) substructure is provided 
for communicating the starting addresses and lengths of 
all data buffers and certain variable length control 
structures. One such Extent Descriptor 52 is shown in 
Fig. 7. Extent Descriptors are substructures used in the 
Queue Descriptor, I/O Descriptor, Transfer Control List 
and Exception Status Block control structures. 

The Extent Descriptor 52 includes a first doubleword 
54 and second doubleword 56 aligned in memory at sequen- 
tial doubleword address memory locations. The high order 
word in the first doubleword 54 is a length field. The 
low order word at bits 0 to 15 is available for control 
structure specific usage. The length field at the high 
order word specifies the number of sequentially ascending 
bytes in the data structure defined by this Extent 
Descriptor. A length value of 0 is not valid and will be 
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rejected by the I/O adapter as an exception. The second 
doubleword 56 of the Extent Descriptor 52 contains an 
address field. The address field specifies the starting 
memory space address of the data structure defined by 
.5 this Extent Descriptor. The Extent Descriptor format 
places no alignment restrictions on the address of the 
target data structure. 

An Interrupt Descriptor ( INTD ) 58 shown in Fig. 9 is 
the substructure used to communicate the conditions upon 

10 which to request interrupts, the destination module which 
is to be interrupted, and the level at which the inter- 
. rupt is to be requested. Interrupt requests are communi- 
cated from I/O adapters to processors, as shown in Fig. 
3, where I/O adapter 22c. is requesting an interrupt to 

15 processor 20b. Interrupt Descriptors 58 are used in 
j_ Mailboxes and Queue Descriptor control structures. 

As is shown in Fig. 8, the interrupt Descriptor 53 
occupies the higher order word of the doubleword 58, i.e. 
bits 16 to 31. The contents of the low order word, bits 

20 0 to 15 are available for control structure specific 

usage. A mask field at bits 23 to 31 contains informa- 
tion pertinent to specific classes of interrupt condi- 
tions. Interrupts are requested only when any of the 
mask bits pertaining to the active conditions are set to 

25 1. If the relevant mask bits are set to a 0, no inter- 
rupt is requested. The occurrence of interrupt condi- 
tions while masked by the adapter is not recorded, so 
interrupts may not be "pending" awaiting setting of their 
mask bit. Onc_e an interrupt request reaches a processor 

30 module it is recorded as pending, even if masked by 
hardware on that module. 

A masked interrupt does not normally affect the pro- 
cessing of control structures (other than the Interrupt 
Descriptor), and does not inhibit continuation of this 

35 processing if such continuation would have happened after 
the interrupt request. One exception is that 
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continuation is inhibited if a previous interrupt remains 
unacknowledged and a subsequent condition occurs which 
could result in an ambiguous status report if the device 
operation were allowed to continue. Interrupts are never 
required when using the I/O control technique of the 
present invention, and all activity may be driven by 
indicators, but when interrupts are used they must be 
acknowledged in a timely manner. The field designated 
module number from bit numbers 24 to 27 is used to iden- 
tify the specific module which is to be interrupted. The 
interrupt address at bit 16 to 23 forms a field which 
contains the interrupt request address on the specified 
module. When used on a system with the bus described in 
the previously mentioned application filed concurrently 
herewith, bits 16 to 27 are used as the control space 
address for a control transfer requesting the interrupt. 

Whenever a command completes or there is an excep- 
tion or any other situation occurs in which there is a 
status to report, an interrupt condition is created 
within the I/O adapter. Interrupt requests are generated 
only as a result of interrupt conditions if interrupts 
for the appropriate type of condition are enabled by the 
mask field in the Interrupt Descriptor. An interrupt 
request is illustrated in Fig. 3 where the I/O adapter 
module 22c sends an interrupt request to the central pro- 
cessor module 20b. 

The Mailbox control structure 30 is better illus- 
trated in Fig. 9. Each Mailbox is a 16 byte structure 
I f °rmed by four sequentially ascending aligned 
' doublewords. The first doubleword is a Command/Status 
□oubleword 50a. The second doubleword in the control 
structure is an Interrupt Descriptor 58a with a 16 bit 
literal field in the low order word. The third 
doubleword 60 contains the doubleword aligned address of 
35 the operand (if any) of the Mailbox command. The fourth 
doubleword 62 is a miscellaneous field to hold 
command-dependent data. 
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A convention followed in Figs. 9, 10, 11, 12 and 13 
is that to the right hand side of each doubievord, its 
relative sequential address in the control structure is 
designated in hexadecimal code. The lowercase "h" fol- 

5 lowing the code indicates hexadecimal notation. 

In the Command/Status Doubleword 50a as shown in 
Fig. 9, the command byte is at bits 0 to 7 and is used to 
hold the command code. The high order byte at bits 8 to 
. 15 of the command word is used to select sub-command 

10 functions of certain commands. The extended status byte 
.at bits 16 to 23 is available for adapter-specific usage. 
Bits 31 and 30 of the basic status byte at bits 24 to 31 
is used to record the status flags which have previously 
been described in conjunction with the Command/Status 

15 Descriptor. 3its 27 to 24 hold the command completion 
status which, in the case of a Mailbox, indicate an 
operation completed successfully, an illegal command code 
was specified, a command was rejected because it could 
not properly be executed with the adapter in its current 

20 state, a specification error in an operand field pre- 
vented successful completion, an invalid, nonexistent, or 
misaligned memory or control space address was specified, 
or a diagnostic failure. 

The various command functions designated by the 

25 states, of the signals in bits 0 to 7 of the 

Command/Status Doubleword 50a include command codes which 
cause no operation and results in an immediate "done- 
status. Another command code requests the report the 
module type, which causes the recipient module to set the 

30 ~ miscellaneous doubleword 62 to reflect the adapter type 
and configuration. A variety of different, arrangements 
can be devised for reporting the module type, however the 
format for the module type doubleword might advanta- 
geously include a description of the type of module, a 

35 description of the installed options or related configu- 
ration details of each particular module, information 
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regarding che hardware functionalL-.y of the module, and 
information regarding the firmware functionality of the 
x modu 1 e . 

Another command code relates to return the 
diagnostic status, which causes the recipient module to 
use the miscellaneous doubleword 62 to report details of 
the completion of adapter self -diagnos is . The format of 
the returned doubleword curing return diagnostic status 
commands is module type dependent. A communication path 
between the module and the main memory can be tested dur- 
ing the execution of the return diagnostic status command 
by writing to and reading back from the miscellaneous 
doubleword 62. rf communication with the main memory is 
not achieved, it is doubtful that the correct status can 
be returned, but the module should attempt to report 
status, including diagnostic failure. 

Another command code is to create queue meaning a 
Queue Descriptor. The command code to create the Queue 
Descriptor causes the adapter to create a Queue for the 
Device number specified by the lower order byte of the 16 
bit literal field in the Interrupt Descriptor 58a. The 
location of the Queue Descriptor for this device is 
specified by the address field 60. Creation of a Queue 
Descriptor causes an implicit Device Attention condition 
to be delivered to the Device associated with the newly 
created Queue Descriptor, so that the command contained 
in the newly created Queue Descriptor will be executed 
immediately following the completion of this command. 
The completion interrupt from the create queue command 
will be requested (if enabled by the mask bit at bit 
position 30 of the INTD 58a) after creating the queue and 
before executing the command in the Queue Descriptor. 
Issuing the create queue command will result in two 
interrupts if both the Mailbox and Queue Descriptor com- 
pletion interrupts are enabled. The normal usage of this 
implicit Device Attention condition is to cause queue 



initialization by creating the Queue Descriptor with an 
"initialize queue" code in its command byte, or to cause 
no additional activity by creating the queue Descriptor 
with a no operation code in its command byte. This 
create queue command will generate a command reject 
exception if a Queue Descriptor for the specified device 
already exists . 

An important advantage of this technique for 
creating Device queues is that, once the queue has been 
created using this Mailbox command, all subsequent commu- 
nication with the device takes place through the allo- 
cated Queue Descriptor. This provides the ability for 
system software to allocate the Queue Descriptor anywhere 
within main memory, rather than having to utilize fixed 
address locations for device control, as on most prior 
art computer systems. 

Another command function which may be coded into the 
command field of the Command/Status Doubleword 50a is 
that of "destroy queue". A destroy queue command causes 
the adapter to cease responding to Device Attention 
requests for the queue with the Device number specified 
by the low order byte of the literal field in doubleword 
58a. Any internal pointers maintained by the adapter for 
ancillary structures associated with the Queue being 
destroyed are invalidated by this command. No accesses 
to main memory for any services related to this Queue 
will be made after execution of the destroy queue 
command, unless the queue is subsequently recreated. If 
no Queue Descriptor exists for the designated Device, 
this command functions as a no operation command. The 
destroy queue command will generate a command reject 
exception if the designated Queue Descriptor is neither 
halted nor idle. 

Another command function which may be coded into the 
command field of the Command/Status Doubleword 50a is 
that of halt I/O. A halt -I/O command function causes the 
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adapter to halt all input/output functions in process on 
all Devices, to cease scanning all Device queues, and to 
cease reporting all ancillary status regarding all 
devices until released by subsequent Device Attention 
requests. The halt I/O command should only be used in 
circumstances in which it is necessary to immediately 
stop input/output activity to prevent corrupted data from 
being transferred. The halt I/O command generates an 
interrupt condition after all of the I/O activity has 
ceased. 

A command to set queue polling rate is also defined 
by a code in the command byte of the Command/Status 
Doubieword 50a. The set queue polling rate command 
causes the adapter to set the time base value used for 
polling of idle Device queues to the value from the lit- 
eral field of doubieword 58a. The 16 bit code in the 
literal field of the doubieword 58a specifies the minimum 
time which must elapse between polling queues for idle 
Devices associated with this I/O adapter to check whether 
new i/o Descriptors have been added to these Device 
queues. Each I/O adapter type has its own default poll- 
ing rate, set internally after the system reset or module 
reset. The set queue polling rate command only needs to 
be used if system software wishes to change from the 
default rate. A value of 0 specifies no delay, and will 
cause the idle queues to be polled as frequently as the 
adapter is able to do so. Values greater than zero spec- 
ify units of a system-defined timebase, which is 8 
milliseconds in the preferred embodiment. 

A last standard command function established by the 
code in the command byte of the Command/Status Doubieword 
50a is that for run extended diagnostics. The run 
extended diagnostics command causes the recipient module 
to run additional internal diagnostics. Modules with 
self-diagnostic capability are known in this art. if a 
module does not have any extended diagnostic capability, 
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it would reply to 'this command with an immediate "done" 
sta.tus. The rur. extended diagnostic command will gener- 
ate a command reject exception if all I/O queues on this 
adapter are not idle. The extended diagnostics are 
specified in an adapter type-specific manner by the lit- 
eral, address and/or miscellaneous fields included within 
the doublewords of the Mailbox. The preceding list 
specifies the standard commands which are supported by 
all adapters. Additional commands may be defined for 
specialized use by particular types of adapters. At 
least 32 command code values are reserved for Mailbox 
commands, with values OOh-lFh used in the preferred 
embodiment. All codes in this range which are not used 
by standard commands defined above are available for 
adapter specific usage. 

The Queue Descriptor control structure 32 is illus- 
trated in greater detail in Fig. 10. Each Queue 
Descriptor 32 is formed by eight sequentially ascending 
doublewords at aligned doubleword address boundaries in 
memory. Each Queue Descriptor is therefore a 32 byte 
structure which is created by commands sent to the 
adapter through its Mailbox. All I/O adapters must sup- 
port Queue Descriptors 32. 

Queue Descriptors hold the control information 
needed by the processors and the I/O adapters to maintain 
the I/O Descriptor Queue for each Device attached to the 
adapter. There is at most one Queue Descriptor for each 
Device attached to the adapter. Such Queue Descripters 
are created by Mailbox commands as discussed above. No 
I/O operations to a device are possible until a Queue 
Descriptor for that device has been created. 

Processors request an I/O adapter to interrogate a 
particular Queue Descriptor by issuing the I/O adapter a 
Device Attention for the appropriate device. Processors 
must request Queue Descriptor re- interrogat ion whenever 
there is a need to perform new Queue Descriptor commands. 
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Processors must also request Queue Descriptor 
re-interrogation when the processor changes certain con- 
trol information in the Queue Descriptor, because I/O 
adapters are not required to recheck Queue Descriptor 
contents between processing of I/O Descriptors and the 
I/O adapters are permitted to retain Queue Descriptor 
information in private memories. 

The first doubleword of the Queue Descriptor struc- 
ture shown in Fig. 10 is a Command/Status Doubleword 50b. 
The Command/Status Doubleword 50b is essentially similar 
to that which has been described in conjunction with the 
Mailbox. However, one difference resides in bits 14 and 
15 of the command modifier byte. Bit 15 is set to a "1" 
to indicate that the I/O Descriptor pointer in the next 
following doubleword 64 is valid. Whenever there are no 
I/O Descriptors on the Device queue, or when the queue 
head pointer is being updated by means of two 16 bit 
write operations by processors with. 16 bit data paths, 
bit 15 must be set to "0" to prevent the adapter from 
using an invalid address from the doubleword 64. Bit 15 
should never be changed from a "1" to a "0" while the 
adapter is processing the Queue Descriptor, as is indi- 
cated by the basic status bit 31 being set to a "1". Bit 
14 is set to a "1" to cause the adapter to request a new 
interrupt as soon as the new interrupt condition occurs, 
without waiting for acknowledgment of a previous inter- 
rupt request. 

The second doubleword at 64 contains a pointer to 
the first I/O Descriptor on this Device queue. This 
pointer is used for Queue management and is never 
modified by the adapter. The only circumstance that the 
doubleword 64 is read by the adapter is during execution 
of "initialize queue" (Mailbox) commands and when 
obtaining the initial I/O Descriptor pointer when polling 
an empty queue. The pointer at doubleword 64 is used by 
the adapter only if the IOD pointer valid flag at bit 15 
of the Command/Status Doubleword 50b is set to a "1". 
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The third doubleword a: 66 contains a pointer to the 
I/O Descriptor currently being processed by the adapter 
when the Device associated with this Queue is busy. 
Alternatively, the doubleword at 66 contains a pointer to 

5 the last I/O Descriptor processed by the adapter when the 
Device associated with this Queue is idle. The pointer 
at doubleword 66 may be read but must never be modified 
by operating system software. The adapter stores a copy 
of the current I/O Descriptor address into this 

10 doubleword at 66 whenever a valid I/O Descriptor is 
fetched from memory during the process of command 
chaining. .During I/O operations, command chaining is the 
action by the adapter of proceeding to the next command 
for a particular Device upon completion of the previous 

15 command, without requiring intervention by any processor. 

The fourth doubleword of the Queue Descriptor con- 
trol structure is an Interrupt Descriptor 58b. The 
Interrupt .Descriptor is contained in the high order woVd 
I at bits 16 to 31. The low order bits at 0 to 15 are an 

20 I interrupt status and ac know 1 edge men £_f_ieJ.d . The contents 
of the doubleword 58b are used to report, mask, identify 
and acknowledge all interrupts results from operation of 
the device associated with this Queue. This includes 
both normal completion conditions and exception condi- 

25 tions, and relates to execution of both Queue Descriptor 
commands and I/O Descriptor commands. 

The interrupt status word 58b of the Queue 
Descriptor control structure 32 is used to communicate 
all interrupts related to Queue Descriptor commands and 
v 30 I/O Descriptor commands. The major characteristics of 

the interrupt reporting mechanism provided by the Inter- 
rupt Descriptor 58b are that all interrupt conditions may 
be masked, allowing interrupt less operation if desired by 
the system software; that interrupt conditions may still 

25 be reported through the interrupt status word of the 

Interrupt Descriptor 58b when inter'rupts*"are' masked; that 
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eaca interrupt condition must be explicitly acknowledged 
by the software before a subsequent condition is 
reported, thereby assuring that no ambiguous status of a 
Device will be reported; and that the presence of a pend- 
ing interrupt condition when a previous interrupt remains 
unacknowledged causes an indicator to be set and further 
processing to be suspended- 
There is a distinction between an interrupt 
condition and an interrupt request under the present 
invention. Many adapter activities can generate inter- 
rupt conditions when they have status to report back to 
the software. These interrupt conditions always result 
in updating of the status information of several of the 
control structures of the present invention, including 
the Command/Status Doubleword of the control structure 
being processed when the condition occurred, the inter- 
rupt status word of the Queue Descriptor for the Device, 
the Exception Status Block if an exception is being 
reported, and the Status Update Summary ( SUS ) Indicator, 
if enabled by a Queue Descriptor command. Interrupt 
conditions result in an interrupt request to a processor 
if interrupts for the appropriate type of condition are 
enabled by the mask field shown at bits 28 to 31 of the 
Interrupt Descriptor 58b. Thus interrupt conditions 
result i- interrupt requests only if the requests are not 
masked. 

The high order word, bits 16 to 31 of the interrupt 
Descriptor 58b specifies the interrupt destination for 
exception, completion, program controlled interrupt 
(PCI), and end_of chain interrupts, and provides indepen- 
dent mask bits for each of these types of interrupt 
conditions. All interrupts associated with a Device are 
routed to a single destination processor at the module 
specified by bits 24 to 27 of the Interrupt Descriptor 
58b. aits 16 to 23 identify the specific interrupt level 
at the designated destination processor. Information in 



WO 88/02149 



PCT/LS87/02394 



-31- 

the interrupt status word, i.e. the lower order word of 
Interrupt Descriptor 58b, allows the interrupt handler on 
this processor to distinguish between different types of 
interrupts. The Interrupt Descriptor is never written to 

5 by the adapter and is always read from main memory by the 
adapter ' before requesting an interrupt. Accordingly, the 
interrupt mask and address information may be changed by 
the processor at any time by writing a 16 bit value into 
the high order word of doubleword 58b. 

10 The interrupt mask bits at bit locations 28 to 31 

may be'coded in any way desired. However, one particular 
arrangement is to set a "1" in bit 31 to enable exception 
interrupts which are generated by exceptional completion 
of Queue Descriptor commands, exceptional completion of 

15 I/O Descriptor commands, time outs of any command func- 
tion, and Queue integrity violations during command 
chaining. Bit 30 may be set to a "1" to enable Queue 
Descriptor completion interrupts which are generated by 
the successful completion of Queue Descriptor commands. 

20 Bit 29 may be set to a "1" to enable PCI interrupts which 
are generated by completing the processing of I/O 
Descriptors with the command modifier bit 14 set to "1". 
Bit 28 may be set to a "1" to enable end of chain inter- 
rupts, which are generated when the device becomes idle 

25 after Successful completion of the last I/O Descriptor in 
the queue. The end of chain condition is also generated 
when the device is halted after successful completion of 
an I/O Descriptor with bit 13 of its command modifier 
^||top chaining] set to a "1". At least one I/O 

30 Descriptor must have been processed before an end of 

chain condition can occur. Executing an initialize queue 
command- for a Queue Descriptor with a null queue or a 
continue command with an invalid link pointer in the cur- 
rent I/O Descriptor does not generate an end of chain 

35 condition. 

The interrupt status and acknowledgement field 
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located at bit locations 0 to L5 of the doubleword 53b, 
also called the interrupt status word, contains informa- 
tion on the cause of the most recent interrupt condition 
from the Device and the current status of the Device 
5 queue processing. The low order byte of this word is 
also used by software to acknowledge interrupt condi- 
t ions . 

Information as to the cause of the most recent 
interrupt condition from the Device is contained in the 

10 low order byte of the interrupt status word. This low 

order byte is available for use by the interrupt handler 
in determining how to handle the interrupts it receives. 
The adapter stores interrupt type information into the 
interrupt status word immediately before requesting the 

15 interrupt, if the interrupt condition is enabled, or upon 
detecting the interrupt condition if the interrupt 
condition is masked. Usage of the bits in the interrupt 
type byte data include, for example, setting bit 7 to a 
"1" to indicate an exception condition as a result of 

20 execution of a Queue Descriptor command. Further status 
information is available in the status word of the 
Command/Status Doubleword of this Queue Descriptor. 3it 
6 is set to a "1" to indicate the successful completion 
of a Queue Descriptor command. Bit 5 may be set to a "1" 

25 -o indicate an exception condition as a result of the 

execution of an I/O Descriptor command. Further status 
information is available from the Command/Status 
Doubleword of the I/O Descriptor indicated by the current 
I/O Descriptor pointer 66 as well as in the Exception 

30 Status Block. _Bit 4 may be set to a "1" to indicate the 
"end of a chain" condition, which means that either the 
last I/O Descriptor on the queue, or an I/O Descriptor 
with a stop chaining flag (command modifier bit 13) set, 
has been encountered. These two causes may be distin- 
35 guished by testing the high order byte of the interrupt 
status word to determine whether the Device is idle (end 
of queue) or halted (chaining stopped). 
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Bit 3 in the interrupt type code may be set to a "I" 
to .indicate that the time out interval specified in the 
Queue Descriptor (low order word of 52a) has elapsed dur- 
ing the execution of the current command without either 

5 command completion or another exception condition. Bit 3 
will be set along with bit 5, since time out is also an 
I/O Descriptor exception condition, and additional status 
information is available on the Exception -Status Block. 
Bit 2 is set to a "1" to indicate that the I/O Descriptor 

10 just completed its PC I request bit (command modified bit 
14) set to a "1". No additional status is relevant. The 
current I/O Descriptor pointer 66 may not be relied upon 
to locate the source of the PCI , since processing of that 
I/O Descriptor has been completed, and the current I/O 

15 Descriptor pointer value may have been updated before the 
interrupt request is received by the processor. However, 
due to the strictly sequential nature of queue processing 
by the adapter, the software which sets the PC I bits may 
track queue processing progress as PCIs are received. 

20 Bit 1 is set to a "1" to indicate that a queue integrity 
exception has occurred during command chaining, which 
means that either the Command/Status Doubleword of the 
I/O Descriptor was not in "pending" status, or that an 
I/O Descriptor link pointer contained a misaligned or a 

25 non-existent memory address. These two conditions may be 
distinguished by testing bit 3 of doubleword 0 of the 
Exception Status Block, as described below, which is set 
to a "1" to indicate an invalid I/O Descriptor link 
pointer. Bit _0 is not currently assigned and will always 

3 0 be set to 0. 

I/O adapters may set more than one bit in the inter- 
rupt status byte of doubleword 58b if more than one 
condition relating to a single Device becomes active 
simultaneously. If an I/O adapter has multiple interrupt 

35 conditions which cannot be reported in this manner, the 
reporting priority is based on the order in which the 



WO 88/02149 



PCT/LS87/02394 



-34- 



bits are assigned in the interrupt type byte. The inter- 
rupt types assigned to higher crder bits of this byte 
have a higher reporting priority. 

The interrupt type byte also serves as an interrupt 
5 acknowledgement indicator to the adapter. when an inter- 
rupt condition for the device has been handled by the 
system software, the interrupt handler must clear the 
interrupt type byte to all zeros. The adapter will not 
request another interrupt for this Device, and will not 
10 store new type information for a masked interrupt 

condition, while the interrupt type byte is non-zero 
(unless an ignore interrupt acknowledgement bit (bit 14) 
in the command modifier byte of the Queue Descriptor's 
Control/Status Doubleword is set to a "1"). If 
15 acknowledgements are being ignored and interrupts are not 
masked, the interrupt type byte will always reflect the 
most recently requested interrupt, which may still be 
pending at the target processor. 

The high order byte, bits 3 to 15, of the interrupt 
20 status word of the Interrupt Descriptor 58b are used to 
indicate the current state of Queue processing. This 
high order byte is never written to by processors. The 
adapter writes this- byte asynchronously with the rest of 
the Queue Descriptor for updating pending interrupt 
25 status and device activity status. Bit 15 is set to a 
"1" by the adapter if an additional interrupt condition 
is pending and the previous interrupt condition has not 
been acknowledged. This bit is not used when the ignore 
interrupt acknowledgement bit (bit 14) in the Queue 
30 Descriptor's eommand modifier is set to a "l". After the 
adapter sets this bit at bit position 15 to a "1", fur- 
ther activity for this Device is inhibited until the 
interrupt condition is acknowledged to prevent loss of, 
or ambiguous reporting of, the status of the device. 
35 While waiting for interrupt acknowledgement with another 
interrupt condition pending, the adapter does not 
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indicate an idle state, and polls the low order byte of 
the interrupt status word for interrupt acknowledgement. 
The new interrupt condition will be reported and the bit 
at location 15 set to "0", as soon as the previous 
5 condition is acknowledged. Any Device Attention request 
to a Device with an additional interrupt pending will 
result in the Queue Descriptor command being rejected 
with an immediate "done" indication and command reject 
completion status in the Queue Descriptor's basic status 
**-■' 10 byte.' 

3it 9 of the interrupt status word is set to a "1" 
by the adapter when the Device becomes idle and is set to 
a "0" when the queue polling (or a Device Attention) 
results in detection of a valid I/O Descriptor pointer at 
15 the link pointer, where the previous chaining has ended. 
When the Device is idle the Queue Descriptor or I/O 
Descriptor command modifier whose bit 15 is being polled 
for a valid I/O Descriptor pointer may be located via the 
current I/O Descriptor pointer 66. Bit 8 is set to a "1" 
20 by the adapter when the Device is halted, as a result of 
a stop chaining request in an I/O Descriptor, a "halt 
device" Queue Descriptor command, a "halt I/O" Mailbox 
command, or an exception condition. Bit 8 is set to a 
"0" when the Device is restarted as a result of a "con- 
25 tinue" or "initialize" Queue Descriptor command. Bits 8 
di " and 9 will never both be set to a "1" simultaneously and 

T ' v when both of these bits are set to a "0" the device is 

active (processing I/O Descriptors). 

The setting of bits 8 and 9 of the interrupt status 
>? 30 word is not meaningful until after the execution of the 
first "initialize queue" command after creation of the 
Queue. These bits only reflect the activity status of 
the I/O Descriptor processing and are not updated as a 
result of Queue Descriptor command processing. Any 
35 attempts to poll for queued command completion using 

these bits must be qualified by first testing for a done 
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status in the basic status byte of the Command/Status 
Doublevord 5Gb of this Queue Descriptor. 

in the Queue Descriptor control structure 32 shovn 
in Fig. 10, the doublewords 52a and 52b contain an Extent 
Descriptor for the Exception Status Block. Whenever an 
exception condition is reported for this Device, the 
adapter stores exception status information into the 
Exception Status Block indicated by this Extent 
Descriptor. The Exception Status Block length is adapter 
type dependent, but might be required to be at least 16 
bytes, as defined below. if the ES3 length in the high 
order byte of 52a is zero, no exception status is 
requested. The lover order word of the doubleword 52a 
contains the time out value for this device. This field 
specifies the number of predetermined time intervals 
(current implementation uses 8 millisecond intervals) 
that must elapse after the adapter initiates any 
operation to this Device before the operation is termi- 
nated with the time out condition indicated as the com- 
pletion status. The time out condition is treated as an 
exception condition for the purposes of interrupt 
requests, with an additional bit in the interrupt type 
byte to distinguish time outs from other forms of excep- 
tions. A time out value of 0 inhibits the time out func- 
t ion . 

The doubleword 72 is available for adaoter specific 
usage by any adapter types which require- addit ional 
information in the Queue Descriptor. The doubleword 74 
is a miscellaneous field for command-dependent data. 

The Device-level command codes of each Queue 
Descriptor 32 are contained in command byte (bits 0 to 7) 
of the Command/Status Doubleword 50b. The Device level 
command codes must be implemented by all I/O adapters 
unless indicated otherwise. 

One Device level command code causes no operation 
but does cause the adapter to re-read the values of 
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doublewords 52a, 52b, 72 and 74 into private memory. The 
"no operation" command is useful when it is necessary to 
change the timeout value, the Exception Status Block 
location, or miscellaneous information when the Queue 

5 does not need to be re- in i t ial i zed . Execution of this 

command results in an immediate "done" status and a com- 
pletion interrupt condition. 

Another Device level command code present at the 
command, byte of the Command/Status Doubleword 50b is one 

10 to "initialize queue", which causes the adapter to store 
the address of the Queue Descriptor into the current I/O 
Descriptor pointer of the doubleword 66, read the values 
of doublewords 52a, 52b, 72 and 74 of the Queue 
Descriptor into its private memory, become active (if 

15 halted), and initiate queue polling at the queue head 
pointer in the doubleword 64. 

With respect to the "initialize queue" Device level 
command, if bit 15 of the Command/Status Doubleword 50b 
is set to a "1" to indicate that the I/O Descriptor Queue 

20 head pointer 64 is valid, the adapter stores a copy of 
this pointer into the current I/O Descriptor pointer at 
doubleword 66 and begins processing the designated I/O 
Descriptor. If bit 15 of the Command/Status Doubleword 
50b is set to a "0" to indicate that the I/O Descriptor 

25 Queue head pointer 64 is not valid, the adapter treats 
this Device as being idle, and commences Queue polling 
with bit 15 of the Command/Status Doubleword 50b being 
periodically tested. In this case the idle bit (bit 9) 
of the extended interrupt status byte of doubleword 53b 

3d is set to a "1" when a "done" status is returned at the 
end of the "initialize queue" command. If a Queue 
Descriptor is initialized with a null Queue (bit 15 of 
the Command/Status Doubleword 50b is set to a "0") the 
system software may place the first I/O Descriptor into 

35 this Queue by storing its address into the doubleword 64 
and then setting bit 15 of the command status doubleword 
5 0b to a "1". 
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Execution of the "initialize queue" command results 
in an immediate "done" status and a completion interrupt 
condition. There will be a subsequent end of I/O 
Descriptor chain completion interrupt condition vhen the 
end of the I/O Descriptor is changed. This command gen- 
erates a command reject exception if executed vhen the 
Device is neither halted nor idle. 

Another device level command code at the 
Command/Status Doubleword 50b is to "halt Device", which 
causes the adapter to halt any I/O operation in progress 
on the Device and to cease scanning the I/O Descriptor 
Queue until released by a subsequent continue command. 
The "halt Device" command generates a completion inter- 
rupt condition when I/O activity has been halted. If an 
I/O Descriptor operation is in progress when this command 
is executed, the operation is terminated with exception 
status indicating that a halt I/O occurred. If the 
device is idle, the "halt Device" command halts Queue 
polling with no exception condition. if the Device is 
already halted, the "halt Device" command has no effect. 

A "continue" command is also one of the Device level 
commands available at the Queue Descriptor Command/Status 
Doubleword 50b. The "continue" command causes the 
adapter to resume processing the I/O Descriptor Queue at 
the next pointer in the I/O Descriptor designated by the 
doubleword 66. If this pointer is flagged as not valid, 
the adapter polls its validity indicator until a valid 
pointer is available. The "continue" command is used to 
restart I/O operation after an end of chain condition, 
exception condition, halt device (QD) command, or halt 
I/O (MB) command. Note that the continuation occurs with 
the I/O Descriptor following the I/O Descriptor at which 
the idle, exception or halt occurred. Execution of this 
continue command results in immediate "done" status and a 
completion interrupt condition. There will be a subse- 
quent end of I/O Descriptor chain completion interrupt 
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condition when the end of the I/O Descriptor chain is 
reached . 

Another Device level command available at the 
Command/Status Doubleword 50b is -o "load statistics 

5 pointer". The "load statistics pointer" command causes 

the adapter to read the contents of the doubleword 74 for 
use as a pointer to a buffer memory in which to store 
Device activity statistics. The specific statistics 
maintain, and the format of the statistics reporting 

10 buffer, are adapter type-specific. Only adapter types 
which implement I/O statistics gathering need to imple- 
ment this command. The statistics pointer is set invalid 
by both the create queue (MB) command and the destroy 
queue (MB) command. Statistics gathering upon queue cre- 

15 ation is inhibited until enabled by this command. Writ- 
ing to a former statistics buffer after the Queue no 
longer exists is also prevented. Once statistics 
gathering is enabled by execution of this command, it may 
not be disabled other than by destroying the Queue. The 

20 "load statistics pointer command" generates a command 

reject exception if executed on an I/O adapter which does 
not support statistics gathering. 

A last significant Device level command available 
from the Command/Status Doubleword 50b is that of "load 

2S status update summary pointer". The "load SUS pointer 
command" causes the adapter to read the contents of the 
doubleword 74 for use as a pointer to the doubleword of 
which the low order byte is the SUS indicator. The SUS 
indicator is set non-0 immediately after the adapter 

30 updates the basic status byte of any Command/Status 

Doubleword associated with this device (QD or IOD) to 
"done" status. The SUS indicator is set non-zero for any 
condition which results in "done" status, including both 
normal completions and exception conditions. All 

35 adapters implement this command. The SUS pointer is set 
invalid by both the create queue (MB) command and the 
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destroy queue (M3) command. SUS reporting upon the Queue 
creation is inhibited until it is enabled by this 
command. Also prevented is the writing to a former SUS 
indicator after the Queue no longer exists. Once SUS 

5 reporting is enabled by execution of this command it may 
not be disabled other than by destroying the Queue. More 
than one SUS pointer may point to the same doubleword, 
since the SUS indicator is updated without regard to the 
previous state of the indicator. 

10 T he I/O Descriptor 34 is shown in greater detail in 

Fig. ll. Each I/O Descriptor contains the basic control 
information for a single Device level operation. An I/O 
Descriptor, along with its ancillary Transfer Control 
List 38 and Device Control 31ock 36 structures (Fig. 2) 

15 fully specify an input/output operation to both the 
adapter and to the external Device controller (if 
present). Each I/O Descriptor is constructed by system 
software and linked onto the Device Queue for the appro- 
priate Device. I/O adapters obtain access to the I/O 

20 Descriptors through the command chaining process, perform 
the indicated operations, and report completion status to 
the status fields of the I/O Descriptors. All I/O 
adapters must support I/O Descriptors. 

I/O Descriptors 34 are eight doublewords in sequen- 

25 tially ascending aligned doubleword locations in memory. 

The first doubleword of the I/O Descriptor 34 is a 
Command/Status Doubleword 50c. The command byte at bits 
0 to 7 is used to hold Device-specific command codes. 
The codes can be specific to any particular adapter; how- 

30 ever, the codes and reserved ranges for read (40h-4FH), 
write (50h-5Fh), Device control functions (seek, etc.) 
(60h-6Fh) and others (70h-7Fh) are incorporated. 

The command modifier byte at bits 8 to 15 indicates 
actions for the adapter to take during the processing of 

35 the command in this I/O Descriptor. The Queue control 
functions include bit 15 which is set to a "1" to 
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indicate that the next I/O Descriptor pointer (doublevord 
76.) contains a valid I/O Descriptor address; bit 14 which 
is set to a "1" to cause the PCI interrupt condition when 
processing of this I/O Descriptor is completed; bit 13, 

5 . which is set to "1" to force command chaining to stop and 
this device to halt, with end of chain status, indepen- 
dent of the value or validity of the next I/O Descriptor 
pointer 76; bit 12, which is set to a "l" to force 
command chaining to continue even if this I/O Descriptor 

10 generates exception status (only intended for use by 

device diagnostic software, which must sometimes know- 
ingly generate exception conditions); and bit 11, which 
is set to a "1" to cause the adapter to use doublewords 
52c and 52d as an Extent Descriptor of the physical I/O 

15 buffer rather than as an Extent Descriptor of the Trans- 
fer Control List. Data linking is not possible when bit 
11 is set to a "1". Data linking is the action by an 
adapter of proceeding to the next data buffer for the 
purpose of continuing the data transfer associated with a 

20 single command upon exhaustion of the byte count of the 

previous data buffer. Bits 12 and 13 are mutually exclu- 
sive with respect to one another. 

The Device specific status byte at bit 16 to 23 of 
, the Command/Status Doubleword 50c of the I/O Descriptor 

25 34 is available for reporting Device specific or adapter 
specific completion status concerning the command. 

The basic status byte at bits 24 to 31 of the 
Command/Status Doubleword 50c is used to report on the 
processing and_ complet ion of the I/O command. Bits 30 

30 • and 31 are the I/O status flags which have previously 
been described in conjunction with the Control/Status 
. Doubleword. Some types of adapters may utilize more than 
one I/O Descriptor in processing a single logical 
operation. In this case only the first I/O Descriptor 

35 must be marked busy at the beginning of the operation 

since the link pointer in a busy I/O Descriptor may not 



WO 88/02149 



PCT/LSS7/02394 



-42- 

be modified by software, thereby guaranteeing that the 
next I/O Descriptor will still be available when needed. 
Bit 23 is set to a "1" when the "done" status is stored 
into this byte if the adapter is generating an interrupt 
condition as a result of this I/O Descriptor, independent 
of the state of the interrupt mask in the Queue 
Descriptor. Bit 28 is set to a "1" to indicate that this 
command has been completed with exception status and that 
details on the exception may be found in the Exception 
Status Block for this Queue. Bits 27 to 24 hold the 
command completion status encoded to indicate that an 
operation completed successfully, an illegal command code 
was specified, the command was rejected because it could 
not be properly executed with the adapter in its current 
state, a specification error in an operand field pre- 
vented successful completion, an invalid or non-existent 
or misaligned memory or control space address was 
specified, an uncorrectable data error or other internal 
fault was detected within the I/O adapter, an 
uncorrectable data error on the external I/O adapter 
interface occurred during the operation, the command 
function was rejected by an external I/O controller, the 
.minimum required data buffer space for the operation 
requested was not available, the operation did not com- 
plete within the time out interval specified in the Queue 
Descriptor, the operation was terminated due to a "halt 
I/O" Mailbox command, the operation was terminated due to 
a "halt device" Queue Descriptor command and others 
including diagnostic failure and various device-specific 
conditions . 

Doubleword 76 is the link pointer for the I/O 
Descriptor queue. This pointer contains the address of 
the next I/O Descriptor for the adapter to process. This 
doubleword is never written to by the adapter and is only 
read and used by the adapter if the IOD pointer valid 
flag (bit 15) of the command modifier is set to a "l". 
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Doublewords 52c and 52d contain an Extent Descriptor 
for the Transfer Control List if bit 11 of the cc.mnand 
modifier is set to a "0", or an Extent Descriptor for the 
data buffer if bit 11 of the command modifier is set to a 

.5 "1". A valid entry in this Extent Descriptor is manda- 
tory if the command requires a data buffer. If the 
Extent Descriptor specifies a Transfer Control List, the 
length value must be a multiple of 8 due to the (8-byte) 
length of Transfer Control List entires, and the address 

i.,10 must be a multiple of four since the control structures 

(> - of the present invention must be doubleword aligned. If 

this Extent Descriptor specifies the data buffer directly 
there are no length nor alignment restrictions. In the 
special case of commands which can never require more 
15 than four bytes to be transferred, doubleword 52d may be 
used as a data buffer in lieu of a Transfer Control List 
or single designated buffer. 

Doublewords 52e and 52f contain an Extent Descriptor 
for the Device Control Block. The length of the Device 
20 Control Block may be variable, although the start address 
of the Device Control Block must be doubleword aligned. 
A Device Control Block must be present if the command 
requires ancillary control information. If a Device Con- 
trol Block is optional for a particular command, its 

,'25 presence may be detected by a non-zero value in the 
Device Control Block length field of the Extent 
Descriptor 52e. In the special case of commands which 
require ancillary information, but which can never 
require more than four bytes of ancillary information, 

. 30 doubleword 52f may be used to hold this control informa- 
tion in lieu of a Device Control Block. 

Doublewords 78 and 80 are available for adapter spe- 
cific usage with types of Devices which require addi- 
tional functionality in their I/O Descripters. Possible 
35 uses of doublewords 78 and 80 include device related con- 
trol or status information of a type which does r.ot 
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justify allocating a Device Control Bloc* or a special 
status buffer. An example is to report data link and 
network level status for a local area netvork interface. 

The Device Control Blocks 36 (Figs. 2 and 5) provide 
aligned doubleword memory location space to store device 
specific control information in support of I/O Descriptor 
commands. As such, the Device Control Blocks are not* 
specifically illustrated. The size and format of the 
Device Control Block is totally adapter dependent, and is 
not constrained to be uniform between adapter types. 
Device Control Blocks should be used only for adapter 
functions which cannot fit their Device specific control 
information into the I/O Descriptor. An example is to 
store SCSI (ANSI X3T9.2 standard) command blocks in Data 
Control Blocks used with SCSI disk control I/O 
Descriptors. 

Details of a Transfer Control List 38 are shown in 
Fig. 12. A Transfer Control List 38 provides access to 
one or more data buffers for use in transferring the data 
associated with a single I/O Descriptor. The Transfer 
Control List is a list of Extent Descriptors, each of 
vhich define a separate I/O buffer. The format of the 
Transfer Control List places no restrictions on length or 
on the alignment of these buffers. The low order word of 
each Extent Descriptor doubleword 52g of the Transfer 
Control List control structure 38 is reserved for possi- 
ble use in holding a command or buffer usage indicator. 
An example of the use of this lower order word would be 
to distinguish buffers holding keys from buffers to 
accept read data or to provide write data for an intelli- 
gent data base processor. The number of Extent 
Descriptors in the Transfer Control List is not limited, 
and may extend beyond the Extent Descriptor 52gand 52h' 
illustrated in Fig. 9. All Extent Descriptors in a given 
Transfer Control List must be at sequentially ascending 
addresses . 
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Details of the Exception Status Block 40 are illus- 
trated in Fig. 13. Each Exception Status Block 40 pro- 
vides space for storing status information concerning 
exception conditions which occurred while performing 

5 Device level commands. There is an Exception Status 

Block associated with each Queue Descriptor, as is shown 
in rigs. 2 and 5, and command chaining is generally . 
stopped when an exception occurs to permit inspection of 
the Exception Status Block contents and initiation of 

10 error recovery activity (if necessary). The Exception 
Status Block is a variable length structure containing 
four or more sequentially ascending doublewords aligned 
at doubleword boundaries in memory. 

The doubleword 86 of the Exception Status Block 40 

15 contains completion status information in the low order 
word and the residual transfer count in the high order 
word. The basic status byte contains bits which indicate 
the type of exception which occurred. Bit 3 is set to a 
"1" to indicate that an invalid I/O Descriptor link 

20 pointer was encountered during command chaining. Bit 2 
is set to a "1" to indicate that the exception was 
detected by error status presented by the external 
interface. Bit 1 is set to a "1" to indicate that the 
Transfer Control List pointer in doubleword 92 of the 

25 Exception Status Block contains meaningful information. 
Bit 0 is set to a "1" to indicate that a direct memory 
access (DMA) transfer (reading or writing an I/O buffer) 
was in progress when the exception occurred, meaning that 
the high order_ word of this doubleword as well as the 

30 doubleword 88 of this Exception Status Block contain 

meaningful information. The Device specific status byte 
at bits 8 to 15 contains additional information regarding 
the exception. The residual direct memory access trans- 
fer count field at bits 16 to 31 contains the number of 

35 bytes remaining to be transferred in the I/O buffer when 
the exception occurred. This value is only meaningful if 
bit 0 of this doubleword is set to "1". 
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Doubleword 88 contains the memory space address 
which would have been used on the next DMA transfer cycle 
if the exception had not occurred. This value is only 
meaningful if bit 0 of doubleword 86 is set to a "1". 

Doubleword 90 contains the address of the I/O 
Descriptor which was being processed when the exception 
occurred. This value is only meaningful if bit 3 of. 
doubleword 86 is set to a "0". Doubleword 92 contains an 
address 8 bytes higher than the Transfer Control List 
entry which was being used when the exception occurred. 
This value is only meaningful if bit 1 of doubleword 86 
is set to a "1". 

Doubleword 94 and additional doublewords (not shown) 
are available if needed to hold information specific to 
the particular type of adapter, Device, and/or error. 

The typical computer system utilizing the present 
invention will have a plurality of I/O devices attached 
to the I/O adapters. Management of these devices from 
system software can involve considerable overhead 
accessing multiple control structures scattered 
throughout main memory. Accordingly, the present inven- 
tion provides the status update summary facility for 
rapid determination that control structures need to be 
inspected. A Status Update Summary (SUS) Indicator 95, 
shown in Fig. 5, may be set whenever any device related 
status (either normal or exceptional) in main memory is 
updated by the adapter. The top level of the system i/o 
management software may use the status update summary 
indicator to control entry to various lower levels of 
device driver .software. instead of using an interruot to 
determine whether the status of any of the devices has 
changed, or examining the various areas of memory 
checking status, both of which require considerable over- 
head, the status update summary indicator can be exam- 
ined . 

The Status Update Summary Indicator 95, shown in 
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Fig. 5, is a doubleword memory location in which the 
update indicator is placed- One Status- Update Summary 
Indicator may be associated with each Queue Descriotor 
32. Each Queue Descriptor 32 can be set with a Status 

^ Update Summary pointer, using a "load status summary 

update pointer" command which uses the Queue Descriptor 
miscellaneous doubleword 74 (Fig. 10) to specify the 
Status Update Summary Indicator address in memory. When- 
ever the I/O adapter makes any change to any 

10 Command/Status Doubleword which results in a "done" 

status, with either normal completion or exception com- 
pletion, the location specified by this pointer will be 
updated by being set non-zero at the same time as the 
adapter sets the "done" status into the Command/Status 

15 Doubleword. By looking at one Status Update Summary 
Indicator location, the software can determine if any 
status related to any given Queue Descriptor has been 
updated. This saves considerable overhead and time in 
determining changes in status. If the total number of 

20 active device queues is small it may be even more effi- 
cient to have more than one Queue Descriptor use the same 
SUS indicator. 

From the foregoi-ng description, it is apparent that 
there is a considerable amount of uniformity between 

25 these control structures. Many of the doublewords within 
eact? control structure are of the same type. This uni- 
formity enhances the utility of the present invention in 
different types of computer systems and for communication 
with different types of I/O devices. The input/output 

30 control technique of the present invention is applicable 
to a wide variety of different I/O Devices, without the 
necessity for devising separate adapter processors or 
writing specific device driver codes for specific types 
of different I/O devices or adapters. 

35 The function of the present invention can now be 

better understood in view of the control structures 
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described. Software or firmware running on the processor 
nodules will begin by placing information into the 
Mailboxes at the fixed addresses. The processors will 
then issue Module Attention signals. A "create queue" 
command from the Mailbox will be sent to each adapter for 
each attached device. Software or firmware on the cen- 
tral processor will build the Queue Descriptors. Each 
module which receives a "create queue" (Mailbox) command 
will store in its internal memory the address of its 
Queue Descriptor. Subsequently, when the adapter 
receives a Device Attention signal for that device, ic 
will be able to locate the Queue Descriptor. Once each 
Queue Descriptor is created, it will remain until a 
"destroy queue" (Mailbox) command is issued. Similarly, 
whenever software running on the processor needs to 
accomplish an I/O operation, it will normally create an 
I/O Descriptor (or re-use a previously completed I/O 
Descriptor) to describe the operation and then enqueue 
onto the Queue for the appropriate Device. Ultimately 
the Device will examine the queue during normal polling 
or as a result of a Device Attention signal. 

The input/output operation will then be accomplished 
as a result of the information contained within the I/O 
Descriptor, and possibly by the use of the Transfer Con- 
trol List and Device Control Blocks. Response to the 
completion, either successful or with exception, of the 
I/O operation will cause the I/O adapter to modify the 
status fields within all appropriate control structures 
(and the entire contents of the Exception Status Block in 
the case of aruexcept ion condition). At some later point 
in time the processor checks the completion status of the 
appropriate I/O Descriptor to determine if the I/O 
operation has been completed. This check only needs to 
be made if the Status Update Summary Indicator indicates 
a changed condition. The processor can continue and use 
the information without having ever been interrupted, 
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resulting in a substantial savings of time and increasing 
the data throughput of the overall system. rf it is 
determined as a result of the examination of the comple- 
tion ■-•s tatus of the appropriate control structure that the 

5 particular I/O operation has not been completed, the pro- 
cessor can wait until it is completed, and can do other 
processing before re-checking the completion status. 

One of the important advantages available from the 
present invention is that the I/O adapters need not be 

10 I/O processors. Accordingly, the central processors 

retain control over the operating system, and the diffi- 
culties in the prior art of attempting to utilize I/O 
processors to execute a portion of the operating system 
code are avoided. The preferred means of implementing 

15 the I/O adapter is in micro code on a common bipolar 
micro sequencer. However, the function of the I/O 
adapter could also be implemented in hardware or in 
software. Sequencers are known in the art, and the func- 
tions to be achieved by an I/O adapter are within the 

20 • capability of one skilled in the art. It is significant 
from an implementation point of view that support for 
this I/O control technique does not require the I/O 
adapter to have a general purpose arithmetic/logic unit 
(ALU), only bit testing and address increment/decrement 

25 capabilities, are required. The following state transi- 
tion-diagram shown in Fig. 14 exemplifies use for one 
device connected to one of the I/O adapter modules . As 
is discussed in conjunction with Figs. 3 and 4, more than 
one device can_ be connected to a physical I/O adapter 

30 module. 

One state transition diagram for the operation of 
the present invention and one device connected to the I/O 
adapter shown in Fig. 14. A power on reset establishes a 
null condition or state at 100. The transition from the 
35 null state is as a result of a Mailbox command which is 
executed in response to a Module Attention based on a 
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command code in the Mailbox Comms.-.d/Status Doubleword. 
One transition is to create a queue and the other transi- 
tion is to destroy the queue. The create queue transi- 
tion establishes a not initialized state of 102. The 

5 destroy queue transition goes frca the not initialized 
state 102 to the null state 100. A Queue Descriptor 
command to initialize the Queue is the transition between 
the not initialized state and a poll request state 104. 
In the poll request state a timing condition is estab- 

10 lished by which to periodically poll the Queue. Polling 
the Queue means monitoring bit 15 of the command modifier 
byte of the Queue Descriptor or the last I/O Descriptor 
completed testing for this bit being set to "1". if the 
Queue is polled and this bit is found to be "0", the 

15 Queue is empty; and under such conditions a transition 

from the poll request state 104 is made to a state desig- 
nated Device idle 106. The transition from the Device 
idle state 106 to the poll request state 104 is labeled 
"timer or queue descriptor continue". The "timer" label 

20 in this transition means that the timer polling rate has 
timed out and it is time to poll the Queue again. The 
time duration of the timer is set by the "set queue poll- 
ing rate" command. The label "queue descriptor continue" 
means that a Device Attention signal has been sent with a 

25 Queue Descriptor command of "continue", meaning that the 
device should proceed with polling. 

If the polling in the poll request state determines 
that the Queue is not empty, a transition from the poll 
request state 104 occurs to a channel request state 108. 

30 In the channel_request state 108, a request is made to 

attempt to activiate a communications channel to the spe- 
cific external physical device from the I/O adapter. A 
transition from the channel request state 108 to a chan- 
nel use state 110 occurs as a result of the successful 

35 activation of this channel. If the allocation of a chan- 
nel fails, there is a transition from the channel use 
state 110 back to the channel request state 108. 



The channel use state 110 is the channel used to 
perform the I/O operation. If- during the process of 
using the channel, a disconnect occurs, meaning that 
there is no functions occurring on the channel and the 
channel may be f ree, the disconnect transition occurs to 
a channel disconnect state 112. A transition from the 
channel disconnect state 112 to the channel use state 110 
occurs when the channel reconnects. An example of this 
is a disk drive, which may disconnect from the channel 
while a seek is in progress and reconnect when its heads 
are positioned over the desired cylinder.. 

When the use of the channel is completed, a transi- 
tion from the channel use state 110 occurs to a poll 
interrupt state 114. Whenever a command completes or 
there is an execution of any of the number of other 
things described previously in conjunction with the 
interrupts, an interrupt condition occurs. The result of 
the interrupt condition may be to do nothing or to 
present an interrupt request. The result depends upon 
how the interrupt mask field is coded in the Queue 
Descriptor. If there is a reason to present an inter- 
rupt, there will be a transition loop on state 114 until 
the last int-errupt has been acknowledged. The transition 
loop is designated "last interrupt unacknowledged". If 
there is no need for an interrupt condition to actually 
present an interrupt request, or if the preceding inter- 
rupt has been acknowledged, this transition from the poll 
interrupt state 114 is labeled "last interrupt 
acknowledged".^ In the last interrupt acknowledged tran- 
sitions, there is a transition from the poll interrupt 
state 114 back to the poll request state 104. 

Transitions from the Device idle state 106, poll 
request state 104, channel request state 108, channel 
disconnect state 112, and the poll interrupt state 114 
occur to a Device halt state 116. The conditions which 
cause a device halt are a stop chaining flag within an 
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I/O Descriptor, or a Queue Descriptor command "halt 
device", a Mailbox command "halt I/O", any exception 
condition while processing the Queue Descriptor or the 
I/O Descriptor, or an operation timeout. Any of these 

5 situations cause the Device halt state to be entered. A 
transition from the Device halt state 116 back to the 
poll request state 104 can be accomplished as a result of 
a Queue Descriptor "continue" command or "initialize 
queue" command. A transition to the null state is 

10 accomplished vith a "destroy queue" command at the 

Mailbox. Support functions such as the set queue polling 
rate (MB) or set SUS pointer ( QD ) commands are handled 
within states 100 and 102 as appropriate. Diagnostic 
functions are not shown in Fig. 14. 

15 Some Devices connected to an I/O adapter are rela- 

tively simple in their operation, and do not require all 
of the states illustrated in the state transition diagram 
of Fig. 14. However, regardless of the simplicity of a 
particular Device, the null state 100, the not ini- 

20 tialized state 102, poll request state 104, device idle 
state 106, poll interrupt state 114, and the Device halt 
state 116 are common to all types of devices. What will 
differ from one kind of Device to another kind of Device 
is the lower three states 108, 110 and 112. In a highly 

25 complex Device, the state 110 may be replaced by many 

additional states depending upon the particular require- 
ments of the type of Device connected to the I/O adapter. 
In very simple Devices, a direct transition from the poll 
request state 104 to the poll interrupt state 114 will 

30 occur, thereby_eliminating the states 108, 110 and 112. 
Further description of the various states is not consid- 
ered necessary, because such states are Device dependent. 

An explanation of certain additional operational 
sequences from the viewpoint of both the processor 

35 software or firmware and the adapter microcode or imple- 
mentation means completes an understanding of the present 



invention. 
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Immediately after cover on reset, the system 
firmware or software should, in the order identified, (a) 
. issue a report module type command to each module, (b) 
issue a return diagnostic status command to each module 

5 determined to be an I/O adapter or processor, and (c) 

build system configuration information based on the type 
and condition of the modules queried. Upon receipt of 
the Module Attentions sent for the report module type and 
return diagnostic status commands, the recipient proces- 

10 sor or adapter should read the designated Mailbox and 
perform the command functions previously described. 
3efore performing any I/O operations to an adapter, at 
least one Queue Descriptor must be created and ini- 
tialized. 

15 Upon detection of a Module Attention, the recipient 

module should, in the order listed, (a) calculate or 
establish the address of the designated Mailbox of the 
module dependent upon the Mailbox address arrangement 
fixed in- the system, (b) read the Command/Status 

20 Doubleword of the designated Mailbox and ensure that byte 
3 indicates "pending" status, (c) write to byte 3 of the 
Command/Status Doubleword to set "busy" status, (d) 
decode the command specified in byte 0 of the 
Command/Status Doubleword, (e) execute the command if it 

25. is a valid Mailbox command, or otherwise report exception 
status upon completion, (f) write completion status 
information, along with "done" status, into byte 3 of the 
command status doubleword; and (g) request the interrupt 
specified in the Interrupt Descriptor if the mask bit 

30 (bit 30) of the Interrupt Descriptor is set to a "1". 

Upon detection of a Device Attention, the recipient 
I/O adapter should, in the order listed, (a) retrieve the 
Queue Descriptor address for the designated Device; (b) 
check if the designated Device has a Queue created and 

35 ignore the Device Attention if there is no Queue; (c) if 
there is a Queue read the Queue Descriptor Command/Status 
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Doubleword; (d) generate a queue integrity exception if 
byte 3 of the Command/Status Doubleword does not indicate 
"pending" status; (e) write to byte 3 of the 
Command/Status Doubleword to set "busy" status; (f) 
decode the command specified in byte 0 of the 
Command/Status Doubleword; (g) execute the command if it 
is a valid Queue Descriptor command, otherwise report 
exception status upon completion; (h) write completion 
status information, along with "done" status into byte 3 
of the Command/Status Doubleword; (i) write interrupt 
status information into byte 0 of the interrupt status 
word, unless a previous interrupt remains unacknowledged 
and interrupt acknowledge is not inhibited; and (j) 
request the interrupt specified by the Interrupt 
Descriptor if the Interrupt mask bit in the Interrupt 
Descriptor for the appropriate interrupt type (completion 
or exception) is set to "1". 

Upon receipt of an interrupt due to an interrupt 
request from an I/O adapter which has been issued a 
Mailbox command, the recipient processor should interro- 
gate the completion status in the Mailbox Command/Status 
Doubleword status word. Upon receipt of an interrupt due 
to an interrupt request from an I/O adapter which has 
been issued a Queue Descriptor command or has been pro- 
cessing a Device Queue, the recipient processor should, 
in the order listed, (a) interrogate byte 0 of the inter- 
rupt status word in the appropriate Queue Descriptor to 
determine the type of interrupt which has occurred and 
the general conditions under which it occurred; (b) 
obtain additional information on the cause of the inter- 
rupt from the status of the Command/Status Doubleword of 
the I/O descripter which was being processed when the 
interrupt condition occurred (not relevant for Queue 
Descriptor command related interrupts), which can be 
found via the current I/O Descriptor pointer in the Queue 
Descriptor (only for completion, exception, and time out 
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interrupts - PCI interrupts must be tracked by the 
software); (c) obtain exception details from the Excep- 
tion Status 31ock if the interrupt type was exception; 
(d) perform whatever continuation, logging and/or 
5 recovery activities which are appropriate for this type 
of interrupt condition; and (e) acknowledge the interrupt 
by clearing byte 0 of the interrupt status word of the 
Queue Descriptor (unless interrupt acknowledgement is 
being ignored) . 
10 The integrity of the I/O Descriptor Queue Linkage 

must be maintained at all times. Queue management is 
only performed by processors, and never by adapters. The 
functions of queue management must therefore be imple- 
mented in software or firmware. To add new I/O 
15 Descriptors to the end of the Queue, it is necessary to, 
in the order listed, (a) set the I/O Descriptor pointer 
valid bit in the new I/O Descriptor to "0"; (b) set the 
next I/O Descriptor pointer in the Last I/O Descriptor on 
the Queue to point to the new I/O descripter; and (c) set 
20 the I/O Descriptor pointer valid bit in what had been the 
last I/O Descriptor on the Queue to a "1". 

If the queue management software needs to force 
immediate processing in the new I/O Descriptor when the 
Device is idle, the software may issue a Device Attention 
fi 25 with a "continue" command in the Queue Descriptor. To 

avoid unnecessary Device Attention requests, the software 
may determine if the Device is idle by testing the idle 
bit (bit 9) in the extended interrupt status byte of the 
Queue Descriptor. The relative positions of the I/O 
"3 0 Descriptor pointer valid bit (bit 15 of the command modi- 
fier) and the head/next I/O Descriptor pointer doubleword 
in the Queue Descriptor and in the I/O Descriptor are 
identical. The handling of adding an I/O Descriptor to 
an empty Queue is identical to adding an I/O Descriptor 
35 to the end of a Queue once the address of the appropriate 
control structure. (Queue Descriptor or I/O Descriptor) is 
obtained. 
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To add a new 1/0 Descriptor to the middle of a 
Queue, it is necessary to, in the order Listed, (a) set 
the I/O Descriptor pointer valid bit in the I/O 
Descriptor after which the insertion is to occur (herein- 
after called the "preceding I/O Descr i otor " ) to "0" 
(changing this bit, as part of this sequence, is allow- 
able even if the I/O Descriptor is "busy"); (b) test the 
I/O Descriptor status flags of the preceding I/O 
Descriptor for "available" or "pending" status, since if 
the status is "busy" or "done" the insertion cannot be 
made at this point in the Queue; (c) if the I/O 
Descriptor status flags indicate "busy" or "done", 
restore the I/O Descriptor pointer valid bit to "1" an d 
terminate this activity (the new I/O Descriptor cannot be 
3 add6d at this P° int L * the Queue); (d) set the next I/O 
Descriptor pointer in the new i/ 0 Descriptor to the value 
of the next I/O Descriptor pointer from the preceding l/o 
Descriptor and set the I/O Descriptor pointer valid bit 
in the new l/o Descriptor to ( e ) set the next I/Q 

20 Descriptor pointer in the preceding I/O Descriptor to 
point to the new i/ 0 Descriptor; and (f) set the I/O 
Descriptor pointer valid bit in the preceding I/O 
Descriptor to "1". 

To remove completed I/O Descriptors from the 
25 beginning of the queue, it is necessary to, in the order 
listed, (a) ensure that the first I/O Descriptor is done 
by testing bits 31 and 30 of its Command/Status 
Doubleword; (b) set the I/O Descriptor pointer valid bit 
in the Command/Status Doubleword of the Queue Descriotor 
30 to 0 (only necessary if there is a possibility that "there 
is an "initialize queue" command in progress for the 
device); (c) copy the next I/O Descriptor pointer value 
from the first I/O Descriptor on the Queue into the Queue 
head pointer of the Queue Descriptor; and (d) set the I/O 
35 Descriptor pointer valid bit in the Command/Status 

Doubleword of the Queue Descriptor to "1" (only necessary 
if this bit was set to 0 earlier in this sequence). 
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To remove the last I/O Descriptor from a Queue, and 
thereby cause the Queue to become empty, it is necessary 
to use a Queue Descriptor command. if no new I/O 
Descriptors are available and Queue polling is to be 

5 halted, the "halt device" command may be used prior to 

removing the last I/O Descriptor from the Queue. If one 
or more new I/O Descriptors are to be substituted for the 
last I/O Descriptor, or if polling of the empty Queue is 
desired, the "initialize queue" command should be used. 

10 Prior to issuing an "initialize queue" command under 

these conditions it is necessary to, in the order listed, 
(a) set the I/O Descriptor Queue head pointer to the new 
I/O Descriptor, (b) set the I/O Descriptor pointer valid 
bit to "1" in the Command/Status Doubleword of the Queue 

15 Descriptor if a new I/O Descriptor was specified in the 
previous step, and otherwise set this bit to 0; (c) set 
the Queue Descriptor basic command byte to indicate an 
"initialize queue" command; and (d) perform a Device 
Attention to the appropriate Device address on the appro- 

20 priate module. This procedure may be used to remove all 
enqueued I/O Descriptors from an idle, Queue independent 
of the number of such I/O Descriptors. 

The adapter must implement the Queue usage, since 
Queue usage is a responsibility of the adapters. This is 

25 to be' distinguished from Queue management, which is the 
responsibility of the processors, since I/O Descriptors 
are used to communicate from processors to I/O adapters. 

In order to poll an idle Queue, it is necessary to, 
in the order listed, (a) wait for expiration of the Queue 

30 polling rate counter; (b) test the state of the I/O 
Descriptor pointer valid bit in the Command/Status 
Doubleword of the last control structure processed when 
the' Queue became idle; and (c) if the I/O Descriptor 
pointer valid bit is set to "0", return to step (a) of 

35 this sequence, or (d) if the I/O Descriptor pointer valid 
bit is set to a "1", use the doubleword immediately 
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following the Command/Status Doubleword as a pointer to 
an I/O Descriptor and follow the procedure explained in 
the next paragraph below. 

To chain to a new I/O Descriptor from either a Queue 
Descriptor or an I/O Descriptor it is necessary to, in 
the order listed, (a) wait for the I/O Descriptor pointer 
valid bit in the Command/Status Doubleword of the control 
structure being chained from to be set to a "1", follow- 
ing the polling procedure explained in the preceding 
paragraph if this bit is set to a "0"; (b) read the 
pointer value in the doubleword immediately following the 
Command/Status Doubleword in the control structure being 
chained from; (c) save the I/O Descriptor pointer in pri- 
vate memory or registers; (d) store the I/O Descriptor 
pointer value in the current I/O Descriptor pointer 
doubleword of the Queue Descriptor of this Device; (e) 
read the Command/Status Doubleword at the address desig- 
nated by the pointer; (f) generate a queue integrity 
exception if byte 3 of the Command/Status Doubleword does 
not indicate "pending" status; (g) write to byte 3 of the 
Command/Status doubleword to set "busy" status; and (h) 
decode the command specified in byte 0 of the 
Command/Status Doubleword. 

Data linking requires considerably less overhead in 
the I/O adapter than does command chaining. If a 
sequence of related data transfers can be done using a 
single command with data linking, this technique is more 
efficient than a sequence of chained commands with one 
buffer each. 

When an adapter detects an error condition during 
device operatic.--., command processing for the device is 
generally stopped. The existence of an error condition 
can be created by the exception status indicator in the 
I/O Descriptor, and/or the occurrence of an interrupt 
with exception status indicated in the interrupt status 
byte of the Queue Descriptor (if exception interrupts are 
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enabled) . when the processor becomes aware of the occur- 
rence of an error it should inspect the completion status 
and the device specific status in the I/O Descriptor, 
inspect the interrupt status in the Queue Descriptor, and 

= inspect the exception status in the Exception Status 

Block. Based on this information the software should be 
able to determine the type of problem and the necessary 
steps for recovery. Once this has been accomplished the 
software should either allow Device processing to resume 

-0 with the I/O Descriptor after the one which generated the 
- exception by issuing a "continue" Queue Descriptor 
command, rebuild the device Queue and restart processing 
at the beginning of the Queue by issuing an "initialize 
queue" Queue Descriptor command, or leave processing 

15 halted if the problem is not recoverable. 

There is an architectural significance to separating 
the levels of the multilevel control structure of the 
present invention, and this significance creates advan- 
tages in the use of the present invention. Increased 

20 power in the form of expressive power, flexibility, or 
ability to adapt to different conditions, etc., is 
increased in direct relationship to the amount of indi- 
rection that is possible. Indirection in this sense 
means the ability to redirect the target operands or data 

25 ''or whatever is being operated upon. The multilevel 

structure of the present invention provides at least four 
■--level's' at which this indirection can be advantageously 
applied, as is shown by the four levels in Fig. 2. In 
general terms, therefore, there is increased expressive 

30 power available from the present invention. This expres- 
sive power is much greater than that which is available 
from -prior known input/output control arrangements. 

The use of the Mailbox and Queue Descriptor creates 
the ability for decoupling the I/O channel command struc- 

35 ture, headed by the Queue Descriptor for each separate 
channel, from the module specific information which is 
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present at the Mailbox level. This creates the advantage 
of permitting channel structures to be created and 
deleted dynamically without having to pre-allocate the 
memory they require. On prior systems which incorporate 
both the module information and the device information at 
the same level, there is a requirement to statically 
allocate the memory for this information and never use 
that memory for any other purpose. Such arrangements 
create restrictions on how the operating system uses its 
main memory. 

The indirection between Queue Descriptors and I/O 
Descriptors of the present invention allows two types of 
functions that are advantageous. One function is the 
ability to create I/O Descriptors, link them on to Device 
Queues, have them processed, and then remove them from 
the Device Queues without ever moving them in memory. 
I/O Descriptors can therefore join and leave Queues with- 
out actually being moved in memory. Another advantage of 
the indirection at this level is the ability for particu- 
lar programs to pre-build sequences of I/O Descriptors 
through instructions instead of having to build the 
structure dynamically. 3y separating the sequencing of 
the operations into a linked list, the structure can be 
varied. In prior systems utilizing chaining, chaining 
consists of going to the next sequential command in a 
linear list. By making the list linked in the present 
invention, various programs can maintain pieces of the 
list and then access the Queue as is needed. 

The reason to have the Transfer Control List inde- 
pendent and separately pointed to from the I/O Descriptor 
is that the buffers where data is to be sent or received 
may be a part of the application program. The I/O 
operations may be performed on behalf of the application 
program by an agent, sometimes called an access method, 
an indexing routine, or the like, at an intermediate 
level of software, and this intermediate level of 
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software controls the operations to be performed at the 
I/O Descriptor level. It is the application program that 
is allocating and de-allocating the buffers to perform 
these operations. By allowing the description of the 

3 buffers to be built separately in a Transfer Control 

List, and then linked in with an indirect pointer from 
the I/O Descriptor, independent management is facilitated 
and the arrangement avoids the need for the I/O 
Descriptor and the Transfer Control List to be a part of 

10 the single structure. The number of buffers can change 
without having to change the length and possibly there- 
fore move in memory the I/O Descriptor. A similar situa- 
tion applies with respect to the Device Control Slock. 
More advantages will become apparent, after the 

15 present invention is fully comprehended by those skilled 
in the art. 

The nature and details of the present invention have 
been described with a degree of specificity. It should 
be understood, however, that the description has been 

20 made by way of preferred example and that the invention 
itself is defined by the scope of the appended claims. 
In the following claims, terms such as Mailbox, Queue 
Descriptor, I/O Descriptor, etc. are employed for memory 
structures for the purposes of designating, not defining, 

25 the various structures recited. The scope of the meaning 
of such terms in the claims is intended to encompass only 
those 'elements . which are specifically defined in the 
claims themselves, and not the full extent of the struc- 
tures described in the foregoing description of a pre- 

30 f erred" embodiment , unless the preferred embodiment ele- 
ments are specifically recited in the claims. 
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Claims 

WHAT IS CLAIMED IS: 

1. A method for communicating between at least one 
processor and at least one input/output (I/O) adaoter in 
a computer system, the computer system also including a 
mainjnemory commonly connected to each processor and each 
I/O adapter and at least one I/O Device connected to the 
I/O adapter by which data is input and output from the 
computer system, the computer system also including an 
operating system recorded within the main memory for con- 
trolling the operational functions of the computer sys- 
tem, said communication process comprising the steps of: 

creating_a_f irst memory structure in the main 
memory for at least " one" of " each I/O adapter and each pro- 
cessor, each first memory structure being designated a 
Mailbox; - 

locating each Mailbox at a predetermined memory 
address which is uniquely associated with each Y/0 
adapter and processor for which a Mailbox has been 
created; 

creating a sec ond m emory structure at a prede- 
termined memory address in the main memory for each 
Mailbox, each second structure being designated a Queue 
Descriptor; 

creating at leas£ one third memory structure at 
a predetermined memory address" in the main memory for 
each Queue Descriptor, each third structure being desig- 
nated an I/O Descriptor; 

placing data in each I/O Descriptor which 
contains information that defines a specific I/O 
operation to be performed by an I/O Device; 

linking each I/O Descriptor associated with an 
I/O device in a Queue in the order in which I/O 
operations are to be performed by the I/O Device to which 
the linked I/O Descriptors relate; 

placing data in each Queue Descriptor which 
includes information that defines the head of the Queue 
of linked I/O Descriptors; 
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placing data in the Mailbox which contains 
information relative to the I/O adapter and which defines 
the address of the Queue Descriptor associated with the 
Ma i lbox ; 

communicating I/O data transfers to and from a 
particular I/O Device by performing operations indicated 
by the information contained in the data placed in each 
I/O Descriptor in the Queue of I/O Descriptors associated 
with the particular I/O Device, and by transferring the 
I/O data between the I/O Device and a predetermined loca- 
tion in main memory; 

communicating control functions associated with 
a particular Device by performing operations indicated by 
the information contained in the data placed in the Queue 
Descriptor associated with the particular Device and by 
returning any data requested by the operation performed 
to a predetermined location in main memory; 

communicating module information between the 
processor and at least one of an I/O adapter or another 
processor by performing the operations indicated by the 
information contained in the data placed in the Mailbox 
associated with the particular module, and by returning 
any data requested by the operation performed to a prede- 
termined location in main memory; and 

establishing all communications by first writ- 
ing the data into the Mailbox, the Queue Descriptor, and 
the I/O Descriptor, and thereafter reading the data 
contained in the Mailbox, Queue Descriptor, and I/O 
Descr iptor . 

2\ A method as defined in claim 1 further 
comprising the steps of: 

indicating for each of the Mailbox, the Queue 
Descriptor and the I/O Descriptor separately, by placing 
data in each, a first status indication that the informa- 
tion is currently awaiting processing, a second status 
indication that the information is being processed, and a 
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third status indication that the information has been 
processed; and 

prohibiting each processor from placing of -.ew 
data in any one of the Mailbox, Queue Descriptor and I/O 
Descriptor whenever said one of the Mailbox, Queue 
Descriptor and I/O Descriptor is in the first or second 
status. 

3. A method as defined in claim 2 further 
comprising the step of indicating for each of the 
Mailbox, Queue Descriptor and I/O Descriptor separately, 
by placing data in each, a fourth status indication that 
the information has previously been interpreted. 

4. A method as defined in claim 1 further 
comprising the steps of: 

interlocking the data within each one of the 
Mailbox, Queue Descriptor and I/O Descriptor by placing 
data in each indicating a status indication that the cro- 
cess represented by the data is not yet completed; and 

prohibiting each processor from placing of new 
data in any one of the Mailbox, Queue Descriptor and I/O 
Descriptor which is indicated as exhibiting a not com- 
pleted status. 

5. A method as defined in claim 1 further 
comprising the steps of: 

25 limiting substantially all of the processing 

functions of the computer system to the processor; and 

performing all activities by the I/O adapter as 
a series of sequential operations created from the' infor- 
mation contained in the data placed in the Mailbox, Queue 

30 Descriptor and_I/0 Descriptor. 

6. A method as defined in claim 1 further 
comprising the step of: 

signaling the I/O adapter for communicating the 
control functions to a selected I/O Device by sending a 
35 Device Attention to the I/O adapter to which the selected 
I/O Device is connected; and 
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causing the I/O adapter to process the Queue 
Descriptor associated with the selected I/O Device in 
response to receipt of the Device Attention. 

7. A method as defined in claim 1 further 
5 comprising the step of: 

signaling the I/O adapter for communicating the 
module information to a selected I/O adapter by sending a 
Module Attention to the selected I/O adapter; and 

causing the I/O adapter to process the Mailbox 
10 associated with the selected I/O module in response to 
the Module Attention. 

8. , A method as defined in claim i further 
comprising the step of: 

signaling the processor for an interrupt by 
15 selectively placing data in the Queue Descriptor and 

Mailbox which contains information specifying an inter- 
rupt . 

9. A method as defined in claim 1 further 
comprising the steps of: 

20 creating a fourth memory structure at a prede- 

termined location in the main memory, each fourth memory 
structure being designated a Device Control Block; 

associating the Device Control Block with an 
I/O Descriptor; 

25 , placing data in the Device Control Block which 

defines a continuation of the data in the I/O Descriptor 
which specifies the I/O operation to be performed by the 
I/O Device associated with the I/O Descriptor; and 

performing operations indicated by the informa- 

3q tion contained in the data placed in the Device Control 
Block and the I/O Descriptor. 

10. A method as defined in claim 1 further 
comprising the steps of: 

indicating for each I/O Descriptor by placing 
35 data. therein a status indication that the information 
within the I/O Descriptor has been processed; 
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creatiag a further memory structure at a prede- 
termined location in main memory; 

associating one further memory structure vith 
each Queue Descriptor; 

placing data in the further memory structure 
containing information indicating that for any I/O 
Descriptor associated with the Queue Descriptor with 
which the further memory structure is associated uoon 
updating of the status indication in any one of the I/O 
Descriptors associated with the Queue Descriptor with 
which the further memory structure is associated; and 

examining the data within the further memory 
structure to determine if the I/O data transferred to a 
particular location in main memory during communication 
of the I/O data transfers should be examined under the 
control of the operating system. 

11. A method as defined in claim 1 further 
comprising the steps of: 

creating a fifth memory structure at a prede- 
termined location in main memory, the fifth memory struc- 
ture being designated as an Exception Status Block; and 

placing data in the Exception Status Block upon 
detection of any error condition of operation of one of 
an I/O adapter or an I/O Device. 

12. A method as defined in claim 1 further 
comprising the step of: 

periodically polling the Queue of I/O 
Descriptors associated with each Queue Descriptor. 

13. A method as defined in claim 1 further 
comprising the-step of: 

proceeding from one I/O Descriptor to the next 
linked I/O Descriptor in the Queue of I/O Descriptors to 
communicate all I/O data transfers associated with each 
I/O adapter in a continuous manner. 

14. A method as defined in claim 1 further 
comprising the steps of: 
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indicating for each of the Mailbox, the Queue 
Descriptor and the I/O Descriptor separately, by placing 
data in each, a first status indication that the informa- 
tion is currently awaiting processing, a second status 

5 indication that the information is being processed, and a 
thi rd" 1 status indication that the information has been 
processed; and 

prohibiting each adapter from placing of new 
data -in any one of the Mailbox, Queue Descriptor and I/O 

10 Descriptor whenever said one of the Mailbox, Queue 

Descriptor and I/O Descriptor is in the third status. 

15. A method as defined in claim 1 further 
comprising the steps of: 

interlocking the data within each one of the 
15 Mailbox, Queue Descriptor and I/O Descriptor by placing 

data in each indicating a status indication that the pro- 
cess represented by the data has been completed; and 

prohibiting each adapter from placing new data 
in any one of the Mailbox, Queue Descriptor and I/O 
20 Descriptor which is indicated as exhibiting a has been 
completed status. 

16. A method as defined in claim 1 further 
comprising the steps of: 

creating a fourth memory structure at a prede- 
25 terminied location in main memory, each fourth memory 
structure being designated a Transfer Control List; 

associating the Transfer Control List with an 
I/O Descriptor; 

placing data in the Transfer Control List which 
30 defines a list of buffer locations in main memory and the 
start address and length count of each buffer location; 
and ■ <, 

communicating data to and from the buffer loca- 
tions by proceeding at the end of the length count of one 
35 buffer location to the start address of the next sequen- 
tial buffer location, as a result of performing the 
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operations indicated by the information contained in the 
data placed in the I/O Descriptor with which the Transfe: 
Control List is associated. 

17. A method as defined in claim 1 further 
compr is ing : 

adding an additional I/O Descriptor to the 
Queue of I/O Descriptors by a processor while processing 
a different I/O Descriptor in the Queue by an adapter, a: 
an operation performed as a consequence by the informa- 
tion contained in the data placed in the Queue 
Descr iptor . 

18. A method as defined in claim 1 further 
comprising: 

removing an I/O Descriptor from the Queue of 
I/O Descriptors vhile processing a different I/O 
Descriptor in the Queue as an operation performed by the 
information contained in the data placed in the Queue 
Descr iptor . 
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